HystoreWiki

2 min de leituraVer em Markdown

Stripe

A Stripe recebe cartões do mundo todo, com o dinheiro caindo na sua conta Stripe. É a escolha para vender a jogadores de fora do Brasil.

Você precisa de uma conta Stripe ativada para receber (com os dados da empresa e a conta bancária cadastrados no Dashboard da Stripe).

O cartão da Stripe no painel com o passo a passo do webhook
O cartão da Stripe no painel com o passo a passo do webhook

1. Copie as chaves de API

  1. No Dashboard da Stripe, abra Desenvolvedores > Chaves de API.
  2. Mude para o modo de produção (o modo de teste fica desligado).
  3. Copie a chave publicável, que começa com pk_live_, e cole no campo Public Key do painel.
  4. Revele e copie a chave secreta, que começa com sk_live_, e cole no campo Secret Key. A Stripe mostra a chave secreta uma vez só: guarde num lugar seguro.

2. Crie o webhook

  1. No Dashboard da Stripe, abra Desenvolvedores > Webhooks e clique em adicionar endpoint.

  2. Cole como destino a URL que o painel mostra. Ela tem este formato:

    URL do webhook
    https://webhooks.hystore.com.br/api/v1/webhooks/stripe/<id da sua loja>
    
  3. Selecione estes eventos:

    Eventos do webhook
    checkout.session.completed
    checkout.session.async_payment_succeeded
    checkout.session.async_payment_failed
    checkout.session.expired
    charge.refunded
    charge.dispute.closed
    
  4. Salve o endpoint e copie o segredo de assinatura, que começa com whsec_.

  5. Cole em Segredo do webhook, no painel.

3. Ligue e salve

Ligue a chave do cartão da Stripe e salve. O jogador paga numa página segura da Stripe e volta para a loja com o pedido aprovado.

Estornos e disputas

Com os eventos charge.refunded e charge.dispute.closed, o estorno e a disputa perdida na Stripe marcam o pedido como Reembolsado sozinhos: as entregas que ainda não tinham saído são canceladas. Veja Pedidos.