HystoreWiki

2 min de lecturaVer en Markdown

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
La tarjeta de Stripe en el panel con el paso a paso del webhook

1. Copia las claves de API

  1. En el Dashboard de Stripe, 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:

    URL del webhook
    https://webhooks.hystore.com.br/api/v1/webhooks/stripe/<id de tu tienda>
    
  3. Selecciona estos eventos:

    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.

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.

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.