Pagamentos por boleto

Uma sessão do Checkout precisa cumprir todas as condições a seguir para aceitar pagamentos com boleto:

• 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 boletos. Ele mostra as diferenças entre o recebimento de pagamentos com cartão e boletos.

Habilitar boletos como forma de pagamento

Ao criar uma sessão do Checkout, é preciso:

1. Acrescentar boleto à lista de formas de pagamento payment_method_types
2. Verificar se todos os itens incluídos em line_items estão na moeda brl.

Stripe::Checkout::Session.create({
  mode: 'payment',
  payment_method_types: ['card'],
  payment_method_types: ['card', 'boleto'],
  # The parameter is optional. The default value of expires_after_days is 3.
  payment_method_options: {
    boleto: {
      expires_after_days: 7
    }
  },
  line_items: [{
    price_data: {
      # To accept `boleto`, all line items must have currency: brl
      currency: 'brl',
      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 da forma de pagamento

Você pode especificar o parâmetro opcional expires_after_days nas opções da forma de pagamento para sua Session, definindo os dias corridos até o vencimento. Por exemplo, se você criar um boleto na segunda-feira e definir expires_after_days como 2, o boleto vencerá na quarta-feira, às 23h59, horário Sao_Paulo (UTC-3). Se a configuração for 0, o boleto vence no final do dia. O parâmetro expires_after_days pode ser de 0 a 60 dias. O padrão é 3 dias. Você pode personalizar os dias de validade padrão na sua conta nas configurações de formas de pagamento

Redirecionar para a interface de boletos da Stripe

Depois de enviar corretamente o formulário do Checkout, o cliente é redirecionado para hosted_voucher_url. O cliente pode copiar o número do boleto ou baixá-lo em PDF nessa página.

A Stripe envia um evento payment_intent.requires_action quando um boleto é criado. Para enviar um e-mail ao cliente com o link para o boleto, pode localizar o link hosted_voucher_url em payment_intent.next_action.boleto_display_details. Saiba mais sobre como monitorar um PaymentIntent com webhooks.

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 no botão Copiar número
• Cor da marca: usada como cor de fundo

Execute seu pedidos

Como o boleto é uma forma de pagamento de notificação posterior, é preciso usar um método como webhooks para monitorar o status do pagamento e gerenciar o processamento de pedidos. Saiba como configurar webhooks e processar pedidos.

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

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

Pagamentos em boleto não podem ser reembolsados. Alguns comerciantes criam um processo exclusivo para repassar o crédito diretamente aos clientes solicitantes.

Não é possível contestar pagamentos por boleto.