Pagamentos por boleto

Uma sessão de checkout precisa satisfazer a seguinte condição para aceitar pagamentos com boleto bancário:

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

Isto orienta você na ativação do Boleto e mostra as diferenças entre aceitar pagamentos usando formas de pagamento dinâmicos e configurar manualmente as formas de pagamento.

Habilitar boletos como forma de pagamento

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

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

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price_data][currency]"=brl \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][unit_amount]"=2000 \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  -d "payment_method_types[0]"=card \
  -d "payment_method_types[1]"=boleto \
  --data-urlencode success_url="https://example.com/success"

Outras opções da forma de pagamento

Você pode especificar um parâmetro expires_after_days opcional nas opções de formas de pagamento para a suaSessão que define o número de dias corridos antes que uma guia de Boleto expire. Por exemplo, se você criar uma guia de Boleto na segunda-feira e definirexpires_after_days para 2, a guia de Boleto expira na quarta-feira às 23:59 (UTC-3), horário da América/Sao_Paulo. Se você defini-lo como 0, a guia de Boleto expira no final do dia. O parâmetro expires_after_days pode ser definido de 0 a 60 dias. O padrão são 3 dias. Você pode personalizar os dias de validade padrão em sua conta nasConfigurações de formas de pagamento.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price_data][currency]"=brl \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][unit_amount]"=2000 \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  -d "payment_method_options[boleto][expires_after_days]"=7 \
  -d "payment_method_types[0]"=card \
  -d "payment_method_types[1]"=boleto \
  --data-urlencode success_url="https://example.com/success"

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.