Aceitar uma transferência bancária

Uma sessão do Checkout precisa cumprir todas as seguintes condições para apoiar pagamentos Bank Transfer:

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

• Você só pode usar itens de linha avulsos (Sessões do Checkout de transferência bancária não aceitam planos de assinatura recorrentes).

Use este guia para habilitar Bank Transfer.

Crie ou recupere um Customer

É necessário associar um objeto Customer para reconciliar o pagamento de cada transferência bancária. Se você já tem um objeto Customer, ignore esta etapa. Caso contrário, crie um objeto Customer.

curl -X POST https://api.stripe.com/v1/customers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

Habilitar Bank Transfer como forma de pagamento

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

1. Definir customer
2. Adicionar customer_balance à lista de payment_method_types
3. Verifique se todos os line_items usam a mesma moeda

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}} \
  -d "line_items[0][price_data][currency]"=usd \
  -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]"=customer_balance \
  -d "payment_method_options[customer_balance][funding_type]"=bank_transfer \
  -d "payment_method_options[customer_balance][bank_transfer][type]"=us_bank_transfer \
  --data-urlencode success_url="https://example.com/success" \
  --data-urlencode cancel_url="https://example.com/failure"

Redirecionar para a página de instruções de transferência bancária hospedada da Stripe

Depois de enviar o formulário do Checkout corretamente,

• Se o cliente já tiver um saldo alto o suficiente para cobrir o valor da solicitação, o pagamento é efetivado imediatamente e o cliente é redirecionado para o success_url.
• Se o saldo do cliente não for alto o suficiente para cobrir o valor da solicitação, o cliente é redirecionado para o hosted_instructions_url. A página tem as instruções para guiar o cliente até a conclusão da transferência.

A Stripe permite a personalização de IUs voltadas ao cliente na página Configurações de marca. As seguintes configurações de marca podem ser aplicadas à página de instruções hospedada:

• Ícone: a imagem de sua marca e nome fantasia da empresa
• Cor da marca: usada como cor de fundo

Executar seus pedidos

Como a transferência bancária é uma forma de pagamento de notificação postergada, você precisa usar um método como webhooks para monitorar o status do pagamento e gerenciar o processamento do pedido. Saiba como configurar webhooks e executar pedidos.

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

Teste a integração simulando o recebimento de uma transferência bancária na API, no Dashboard ou usando uma versão beta da Stripe CLI.