Aceitar um pagamento OXXO

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).

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:

1. Acrescentar oxxo à lista de payment_method_types
2. Verifique se todos os line_items usam a moeda mxn.

Stripe::Checkout::Session.create({
  mode: 'payment',
  payment_method_types: ['card'],
  payment_method_types: ['card', 'oxxo'],
  # The parameter is optional. The default value of expires_after_days is 3.
  payment_method_options: {
    oxxo: {
      expires_after_days: 2
    }
  },
  line_items: [{
    price_data: {
      # To accept `oxxo`, all line items must have currency: mxn
      currency: 'mxn',
      product_data: {
        name: 'T-shirt',
      },
      unit_amount: 2000,
    },
    quantity: 1,
  }],
  success_url: 'https://example.com/success',
  cancel_url: 'https://example.com/cancel',
})

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 executar pedidos.

Os seguintes eventos são enviados quando há mudança no status do pagamento:

Para testar a integração do Checkout, selecione OXXO como forma de pagamento e clique em Pagar.