# Pagamentos por boleto

Aceite pagamentos por boleto, uma forma de pagamento com uma guia no Brasil.

O boleto é uma forma de pagamento oficial baseada em uma guia no Brasil, regulamentada pelo Banco Central do Brasil. Para concluir uma transação, os clientes recebem um voucher referente ao valor devido e efetuam o pagamento antes do vencimento em uma agência ou banco autorizado, caixa eletrônico ou portal bancário online.
Payment method family: Vouchers
Usability: Reusable
Access type: Instant provisional access
Payment confirmation timing: Up to 1 business day
Settlement timing: Up to 2 business days (T+2)
Pricing: https://stripe.com/pt-br/pricing/local-payment-methods#boleto-bancario
## Elegibilidade e disponibilidade

### Elegibilidade da conta
Business location: BR
Account type: ✓ Merchant, ✓ Platform or marketplace (Connect)
Business model: ✓ B2B, ✓ B2C
Sua conta poderá ser revisada após a ativação para confirmação de elegibilidade. Embora o Boleto não imponha requisitos adicionais de site, certifique-se de fornecer um site que atenda aos [requisitos de ativação da conta Stripe](https://support.stripe.com/questions/business-website-for-account-activation-faq). Você pode entrar em contato com o [suporte da Stripe](https://support.stripe.com/) para contestar eventuais restrições de uso do Boleto.

Esta forma de pagamento não tem requisitos de MCC.

Contas Stripe nos seguintes países podem aceitar pagamentos por boleto com liquidação de fundos na moeda compatível.

AMER: BR

Clientes nos seguintes países podem utilizar o boleto.

AMER: BR

### Suporte ao pagamento
Customer location: BR
Presentment currency: BRL
Geographic coverage: ✓ Domestic, ✗ Crossborder
Transaction limits: Minimum amount: 5.00 BRL

Maximum amount: 49,999.99 BRL
## Capacidades
Recurring payments: ✓ Supported

Payment authorizations:
  ✗ Extended authorizations
  ✗ Flexible extended authorizations
  ✗ Incremental authorizations
  ✗ Decremental authorizations
  ✗ Re-authorizations

Payment captures:
  ✗ Manual capture
  ✗ Partial capture
  ✗ Multi-capture
  ✗ Over-capture

Refunds:
  ✗ Partial refunds
  ✗ Full refunds

Disputes:
  ✗ Partial disputes
  ✗ Full disputes
### Contestações

O boleto não oferece suporte ao processo padrão de contestação, e os clientes não podem registrar um estorno. No entanto, em algumas situações, podem ocorrer irregularidades bancárias semelhantes a contestações, como falhas no processamento do pagamento. Se isso ocorrer, a Stripe entrará em contato para informar os próximos passos.

## Suporte a produtos Stripe
Checkout UIs:
  ✓ Full page (Recommended)
  ✓ Payment Links
  ✓ Embedded form
  ✓ Payment Element
  ✗ Express Checkout Element
  ✗ Payment Method Messaging Element
  ✗ In-app payments

Products:
  ✗ Managed Payments
  ✓ Billing
  ✓ Invoicing
  ✗ Adaptive Pricing
  ✓ Customer Portal
  ✗ Radar
  ✗ Terminal
  ✓ Connect

APIs:
  ✓ Checkout Sessions (Recommended)
  ✓ Payment Intents
  ✓ Payment Intents with setup_future_usage
  ✓ Setup Intents
  ✗ Off-session payments
### Comece já

Para começar a utilizar uma de nossas interfaces hospedadas, siga um guia rápido:

- [Checkout](https://docs.stripe.com/checkout/quickstart.md): nossa página de checkout pré-integrada e hospedada.
- [Elements](https://docs.stripe.com/payments/quickstart.md): nossos componentes da IU prontos para uso.

#### Outros produtos de pagamento

Os seguintes produtos da Stripe também permitem adicionar Boleto diretamente pelo Dashboard:

- [Invoicing](https://docs.stripe.com/invoicing/no-code-guide.md)
- [Payment Links](https://docs.stripe.com/payment-links.md)
- [Assinaturas](https://docs.stripe.com/billing/subscriptions/overview.md)

Confira o [exemplo de boleto no GitHub](https://github.com/stripe-samples/accept-a-payment).

## Experiência do cliente

#### 1. Select Boleto

The customer selects Boleto at checkout and provides the required contact and tax ID details.

#### 2. Receive voucher

Stripe displays a hosted voucher page where the customer can copy the Boleto number or download the voucher PDF. The voucher expires after 3 days by default, configurable from 0–60 days.

#### 3. Pay the voucher

The customer pays through a bank, ATM, authorized agency, or online bank portal. Desktop and mobile customers use the same hosted-voucher browser flow.

#### 4. Payment complete

After the customer pays, Stripe confirms the payment asynchronously, typically on the next business day, and the customer receives confirmation that the payment is complete.

### Identificadores de transação

A guia do Boleto ou o recibo bancário pode exibir Stripe como a empresa. A formatação exata depende do banco do cliente ou do canal de pagamento.

Para Boleto e outros pagamentos que não sejam com cartão, é possível definir a [descrição no extrato](https://docs.stripe.com/get-started/account/statement-descriptors.md) completa utilizando o parâmetro `statement_descriptor`. Caso não seja definida uma descrição no nível da requisição, a Stripe utiliza a descrição no extrato definida no nível da conta. O parâmetro `statement_descriptor_suffix` se aplica somente a pagamentos com cartão. Um banco pode exibir as informações da descrição no extrato de forma diferente ou omiti-las.

Para destination charges do Connect sem `on_behalf_of`, a descrição no extrato é proveniente da conta da plataforma. Quando você utiliza `on_behalf_of`, ela é proveniente da conta conectada, sujeita ao comportamento de versões legadas da API. Saiba mais sobre [descrições no extrato com o Connect](https://docs.stripe.com/connect/statement-descriptors.md).

Utilize `payment_intent.next_action.boleto_display_details.number` para recuperar o número do Boleto visível ao cliente. Esse número identifica a guia, mas não é um ID de transação do processador. O Boleto não disponibiliza um ID de transação do processador em `latest_charge.payment_method_details.boleto`.

## Ativar Boleto

Se você usar os produtos de frontend da Stripe, habilite o Boleto nas [configurações de formas de pagamento](https://dashboard.stripe.com/settings/payment_methods). A Stripe determina automaticamente quais formas de pagamento são mais pertinentes para cada cliente.

Se a integração exigir a listagem manual das formas de pagamento, é possível [configurar o Boleto como uma forma de pagamento aceita](https://docs.stripe.com/payments/boleto/accept-a-payment.md).
