Aceitar um pagamento OXXO
Cuidado
Stripe automatically presents your customers payment method options by evaluating their currency, payment method restrictions, and other parameters. We recommend that you configure your payment methods from the Stripe Dashboard using the instructions in Accept a payment.
Se quiser continuar a configurar manualmente as formas de pagamento apresentadas aos clientes com o Checkout, use este guia (por exemplo, para aceitar pagamentos no modo de assinatura). Caso contrário, migre para o Dashboard.
O OXXO é uma forma de pagamento de uso único, que exige que o cliente siga instruções adicionais para finalizar o pagamento. Os clientes pagam em dinheiro apresentando uma guia OXXO com um número gerado em uma loja de conveniência OXXO.
Verificar a compatibilidade
Uma sessão do Checkout precisa cumprir todas as condições a seguir para aceitar pagamentos com OXXO:
- Os preços de todos os produtos incluídos no checkout precisam estar na mesma moeda. Se você tiver produtos em moedas diferentes, crie sessões do Checkout separadas para cada moeda.
- Adicione apenas itens de linha cujas vendas sejam avulsas (isto é, não são aceitos planos de assinatura recorrentes).
Aceitar um pagamento
Observação
Crie uma integração para aceitar um pagamento com o Checkout antes de usar este guia.
Use este guia para saber como habilitar o OXXO. Ele mostra as diferenças entre o recebimento de pagamentos com cartão e OXXO.
Habilitar OXXO como forma de pagamento
Ao criar uma sessão do Checkout, é preciso:
- Acrescentar
oxxo
à lista depayment_method_types
- Verifique se todos os
line_items
usam a moedamxn
.
Outras opções de forma de pagamento
Você pode especificar o parâmetro opcional expires_after_days
nas opções da forma de pagamento para o Session
, definindo o número de dias corridos após os quais uma guia OXXO vence. Por exemplo: se você criar uma guia OXXO na segunda-feira e a configuração de expires_after_days
for 2, a guia vencerá na quarta-feira, às 23h59, horário da América/Mexico_City (UTC-6). O parâmetro expires_after_days
pode ser de 1 a 7 dias. O padrão é 3 dias.
Redirecionar para a interface de guias da Stripe
Depois de enviar corretamente o formulário do Checkout, o cliente é redirecionado para hosted_voucher_url
. O cliente pode encontrar o código de barras ou imprimir a guia OXXO nessa página. O hosted_voucher_url
fica em payment_intent.next_action.oxxo_display_details.
A Stripe permite personalizar as IUs exibidas para seus clientes na página Configurações da marca. As seguintes definições de marca podem ser aplicadas à guia:
- Ícone: a imagem de sua marca e nome fantasia da empresa
- Cor de destaque: usada como a cor do botão Imprimir
- Cor da marca: usada como cor de fundo
Executar seus pedidos
Como o OXXO é uma forma de pagamento de notificação posterior, é preciso usar um método como webhooks para monitorar o status do pagamento e gerenciar a execução de pedidos. Saiba como configurar webhooks e finalizar pedidos.
Os seguintes eventos são enviados quando há mudança no status do pagamento:
Nome do evento | Descrição | Próximas etapas |
---|---|---|
O cliente enviou o formulário do Checkout. A Stripe gerou a guia OXXO. Você pode enviar o link do | Espere que o cliente pague a guia OXXO. | |
checkout.session.async_payment_succeeded | O cliente pagou a guia OXXO corretamente. O status do PaymentIntent muda para succeeded . | Execute o pedido de mercadorias ou serviços do cliente. |
checkout.session.async_payment_failed | A guia OXXO venceu ou o pagamento não foi concluído. O PaymentIntent retorna para o status de requires_payment_method . | Entre em contato com o cliente por e-mail e solicite que seja feito um novo pedido. |
Teste sua integração
Para testar a integração do Checkout, selecione OXXO como forma de pagamento e clique em Pagar.
Descrição | |
---|---|
| Simula uma guia OXXO paga pelo cliente depois de 3 minutos, com o webhook Exemplo: fulano@test.com |
| Simula uma guia OXXO paga imediatamente pelo cliente, com o webhook Exemplo: succeed_immediately@test.com |
| Simula uma guia OXXO que vence sem ser paga pelo cliente, com o webhook O campo Exemplo: expire_immediately@test.com |
| Simula uma guia OXXO que vence sem ser paga pelo cliente, com o webhook O campo Exemplo: expire_with_delay@test.com |
| Simula uma guia OXXO que expira sem ser paga pelo cliente, com o webhook Exemplo: fill_never@test.com |