# Stripe

Stripe cobra tarjetas de todo el mundo, con el dinero cayendo en tu cuenta de
Stripe. Es la elección para vender a jugadores de fuera de Brasil.

Necesitas una cuenta de Stripe activada para cobrar (con los datos de la empresa y
la cuenta bancaria registrados en el Dashboard de Stripe).

![La tarjeta de Stripe en el panel con el paso a paso del webhook](shots/payments-stripe.webp)

## 1. Copia las claves de API

1. En el [Dashboard de Stripe](https://dashboard.stripe.com/apikeys), abre
   **Desarrolladores > Claves de API**.
2. Cambia al modo de producción (el modo de prueba desactivado).
3. Copia la **clave publicable**, que empieza con `pk_live_`, y pégala en el campo
   **Public Key** del panel.
4. Revela y copia la **clave secreta**, que empieza con `sk_live_`, y pégala en
   **Secret Key**. Stripe muestra la clave secreta una sola vez: guárdala en un
   lugar seguro.

## 2. Crea el webhook

1. En el Dashboard de Stripe, abre **Desarrolladores > Webhooks** y haz clic en
   agregar endpoint.
2. Pega como destino la URL que muestra el panel. Tiene este formato:

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

3. Selecciona estos eventos:

   ```text Eventos del webhook
   checkout.session.completed
   checkout.session.async_payment_succeeded
   checkout.session.async_payment_failed
   checkout.session.expired
   charge.refunded
   charge.dispute.closed
   ```

4. Guarda el endpoint y copia el **secreto de firma**, que empieza con `whsec_`.
5. Pégalo en **Secreto del webhook**, en el panel.

> [!WARNING]
> El secreto del webhook es obligatorio. Sin él, la tienda no puede confirmar que el
> aviso vino de verdad de Stripe, y el pedido pagado nunca se confirma.

## 3. Activa y guarda

Activa el interruptor de la tarjeta de Stripe y guarda. El jugador paga en una
página segura de Stripe y vuelve a la tienda con el pedido aprobado.

> [!NOTE]
> El checkout de Stripe no informa si la venta fue con tarjeta o con otro medio, así
> que Finanzas usa la tarifa de la tarjeta para todas las ventas de Stripe. Mira
> [Tarifas de las pasarelas](/es/payments/fees/).

## Reembolsos y disputas

Con los eventos `charge.refunded` y `charge.dispute.closed`, el reembolso y la
disputa perdida en Stripe marcan el pedido como **Reembolsado** solos: las entregas
que todavía no habían salido se cancelan. Mira [Pedidos](/es/products/orders/).