# PayPal

PayPal cobra pagos de jugadores de todo el mundo, con la cuenta PayPal o la
tarjeta, y el dinero cae en tu cuenta de PayPal.

Necesitas una **cuenta PayPal Business**: es gratis y distinta de la cuenta
personal. Si todavía no tienes una, créala en
[paypal.com](https://www.paypal.com/br/business) y confirma el correo antes de
seguir.

![El paso a paso de PayPal abierto en el panel](shots/payments-paypal.webp)

## 1. Entra al portal de desarrolladores

1. Ve a [developer.paypal.com](https://developer.paypal.com/).
2. Haz clic en **Log in to Dashboard** y entra con el correo y la contraseña de la
   cuenta Business.

## 2. Crea la app y copia las credenciales

1. En el menú de la izquierda, haz clic en **Apps & Credentials**.
2. Haz clic en **Create App**, ponle un nombre (por ejemplo, `Rede Pixel`) y haz
   clic en **Create App**.
3. Copia el **Client ID** y pégalo en el campo del panel.
4. Haz clic en **Show**, debajo del Client ID, para revelar el **Client Secret**.
   Cópialo y pégalo en el campo del panel.

> [!WARNING]
> Guarda el Client Secret en un lugar seguro. Si cierras la página sin copiarlo,
> tendrás que generar otro.

## 3. Registra el webhook

1. En la misma página de la app, baja hasta **Webhooks** y haz clic en **Add
   Webhook**.
2. En **Webhook URL**, pega la URL que muestra el panel. Tiene este formato:

   ```text URL del webhook
   https://webhooks.hystore.com.br/api/v1/webhooks/paypal/<id de tu tienda>
   ```

3. En **Event types**, marca solo estos eventos:

   ```text Eventos del webhook
   Checkout order approved
   Payment capture completed
   Payment capture denied
   Payment capture refunded
   Payment capture reversed
   ```

4. Haz clic en **Save Webhook**.
5. PayPal muestra el webhook creado con un código, como `5XA12345ABCDE`. Cópialo y
   pégalo en el campo **Webhook ID** del panel.

## 4. Sandbox o producción

El portal de PayPal empieza en el modo **Sandbox** (prueba, con dinero ficticio).
Haz una compra de prueba. Cuando todo funcione, vuelve al portal, cambia a **Live**
arriba, y repite los pasos 2 y 3 para tomar las credenciales y el Webhook ID de
producción. En el panel, la tarjeta de PayPal muestra **PRODUCCIÓN** o
**SANDBOX**.

> [!TIP]
> Las credenciales de Sandbox y de Live son distintas, y el webhook también. Si la
> tienda está en producción y el pedido no se aprueba, revisa que el Webhook ID
> pegado sea el de Live.

## Guía para los jugadores

El botón **Agregar guía de pago a la Wiki de la tienda** crea en la wiki de tu
tienda un artículo que explica al jugador cómo pagar con PayPal, paso a paso.