Pagamentos por boleto
Veja como aceitar boletos, uma forma de pagamento comum no Brasil.
Cuidado
A Stripe apresenta automaticamente as opções de forma de pagamento aos clientes avaliando a moeda, as restrições de forma de pagamento e outros parâmetros deles. Recomendamos que você configure suas formas de pagamento no Stripe Dashboard seguindo as instruções em Aceitar um pagamento.
Se você quiser continuar configurando manualmente as formas de pagamento que apresenta aos clientes com o Checkout, use este guia. Caso contrário, atualize sua integração para configurar as formas de pagamento no Dashboard.
Boleto é uma forma de pagamento de uso único, que exige que o cliente siga instruções adicionais para finalizar o pagamento. Os Clientes pagam usando um boleto com um número gerado em caixas eletrônicos, bancos, internet banking ou agências autorizadas.
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.
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 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:
- Acrescentar
boletoà lista de formas de pagamentopayment_method_ types - Verificar se todos os itens incluídos em
line_estão na moedaitems brl.
Outras opções da forma de pagamento
Você pode especificar o parâmetro opcional expires_ 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_ 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_ 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
Observação
Ao contrário dos pagamentos com cartão, o cliente não é redirecionado para o success_url nos pagamentos com boleto.
Depois de enviar corretamente o formulário do Checkout, o cliente é redirecionado para hosted_. 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_ 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:
| Nome do evento | Descrição | Próximas etapas |
|---|---|---|
O cliente enviou o formulário do Checkout. A Stripe gerou o boleto. Você pode enviar o link do | Espere que o cliente pague o boleto. | |
| checkout.session.async_payment_succeeded | O cliente pagou o boleto corretamente. O status do PaymentIntent muda para succeeded. | Execute o pedido de mercadorias ou serviços do cliente. |
| checkout.session.async_payment_failed | O boleto venceu ou o pagamento não foi concluído. O PaymentIntent retorna para o status de requires_. | Entre em contato com o cliente por e-mail e solicite a realização de um novo pedido. |
Para testar a integração do Checkout, selecione Boleto como forma de pagamento e clique em Pagar.
| Descrição | |
|---|---|
| Simula um boleto pago pelo cliente depois de 3 minutos, com o webhook Exemplo: fulaninho@exemplo.com.br |
| Simula um boleto pago imediatamente pelo cliente, com o webhook Exemplo: succeed_immediately@exemplo.com.br |
| Simula um boleto que vence sem ser pago pelo cliente, com o webhook O campo Exemplo: expire_immediately@exemplo.com.br |
| Simula um boleto que vence sem ser pago pelo cliente, com o webhook O campo Exemplo: expire_with_delay@exemplo.com.br |
| Simula um boleto que nunca é pago; ele expira de acordo com o campo Exemplo: fill_never@exemplo.com.br |
| Código Fiscal | Descrição |
|---|---|
CPF CNPJ | Em uma área restrita, defina |
Pagamentos em boleto não podem ser reembolsados. Alguns comerciantes criam um processo exclusivo para repassar o crédito diretamente aos clientes solicitantes.
Você pode habilitar e-mails com instruções de pagamento do boleto na página Configurações de e-mail no Dashboard. Após a habilitação, a Stripe envia e-mails com instruções de pagamento na confirmação do PaymentIntent. Os e-mails contêm o número do boleto e um link para a página do boleto hospedada na Stripe.
Observação
Nos ambientes de teste, os e-mails com instruções só são enviados para endereços de e-mail vinculados à conta Stripe.