# Transferência bancária Aceite pagamentos por transferência bancária nas suas faturas. If your integration uses [customer-configured Accounts](https://docs.stripe.com/api/v2/core/accounts/create.md#v2_create_accounts-configuration-customer), replace `Customer` and event references in the code examples with the equivalent Accounts v2 API references. For more information, see [Represent customers with Account objects](https://docs.stripe.com/connect/use-accounts-as-customers.md). Você pode oferecer aos clientes a possibilidade de pagar suas faturas com transferências bancárias, como ACH nos EUA ou Bacs no Reino Unido. A Stripe cria um número de conta bancária virtual único e o exibe na fatura em PDF e na [página da fatura hospedada](https://docs.stripe.com/invoicing/hosted-fatura-page.md), para que seus clientes saibam para onde enviar os fundos. A Stripe reconcilia automaticamente essas transferências bancárias com as faturas corretas quando são recebidas. Se não conseguirmos reconciliar uma transferência automaticamente, ela permanecerá no saldo do cliente até que você a reconcilie manualmente. Esse método permite aceitar transferências bancárias sem expor seus próprios dados bancários. ## Receber uma transferência bancária Você pode habilitar transferência bancária como forma de pagamento aceita no Dashboard ou na API. #### Dashboard Para habilitar transferências bancárias como forma de pagamento padrão para faturas em USD e GBP: 1. No Stripe Dashboard, acesse **Configurações** > **Billing** > [Faturas](https://dashboard.stripe.com/settings/billing/invoice). 1. Em **Formas de pagamento padrão**, selecione **Editar formas de pagamento**. 1. Na página seguinte, clique em **Ativar** para **Transferência bancária**. 1. Depois que a forma de pagamento por transferência bancária mostrar um status ativo, os pagamentos por transferência bancária serão exibidos por padrão para toda nova fatura que você criar. > Para todas as outras moedas, não é possível habilitar transferência bancária como forma de pagamento padrão. Porém, você pode adicioná-la como forma de pagamento em faturas de pessoas físicas. #### API O diagrama a seguir mostra uma visão geral das etapas comuns ao aceitar um pagamento por transferência bancária: Etapas comuns ao aceitar um pagamento por transferência bancária (See full diagram at https://docs.stripe.com/invoicing/bank-transfer) Para habilitar transferências bancárias, adicione `customer_balance` a uma fatura usando a API. Em seguida, faça uma chamada da API para criar uma fatura com transferências bancárias como forma de pagamento. #### UE Primeiro, você cria uma fatura. ```curl curl https://api.stripe.com/v1/invoices \ -u "<>:" \ -d "customer={{CUSTOMER_ID}}" \ -d "payment_settings[payment_method_types][]=customer_balance" \ -d "payment_settings[payment_method_options][customer_balance][funding_type]=bank_transfer" \ -d "payment_settings[payment_method_options][customer_balance][bank_transfer][type]=eu_bank_transfer" \ -d "payment_settings[payment_method_options][customer_balance][bank_transfer][eu_bank_transfer][country]=NL" \ -d collection_method=send_invoice \ -d days_until_due=30 ``` Em seguida, pode adicionar um ou mais itens de fatura à fatura. ```curl curl https://api.stripe.com/v1/invoiceitems \ -u "<>:" \ -d amount=1234 \ -d currency=eur \ -d "customer={{CUSTOMER_ID}}" \ -d "description=Professional services" \ -d "invoice={{INVOICE_ID}}" ``` Em seguida, você pode finalizar a fatura. ```curl curl -X POST https://api.stripe.com/v1/invoices/{{INVOICE_ID}}/finalize \ -u "<>:" ``` Após a finalização da fatura, o cliente pode ver as instruções de pagamento na página da fatura hospedada. O URL da página da fatura hospedada é incluído na resposta da API como `hosted_invoice_url`. #### Reino Unido Primeiro, você cria uma fatura. ```curl curl https://api.stripe.com/v1/invoices \ -u "<>:" \ -d "customer={{CUSTOMER_ID}}" \ -d "payment_settings[payment_method_types][]=customer_balance" \ -d collection_method=send_invoice \ -d days_until_due=30 ``` Em seguida, pode adicionar um ou mais itens de fatura à fatura. ```curl curl https://api.stripe.com/v1/invoiceitems \ -u "<>:" \ -d amount=1234 \ -d currency=gbp \ -d "customer={{CUSTOMER_ID}}" \ -d "description=Professional services" \ -d "invoice={{INVOICE_ID}}" ``` Em seguida, você pode finalizar a fatura. ```curl curl -X POST https://api.stripe.com/v1/invoices/{{INVOICE_ID}}/finalize \ -u "<>:" ``` Após a finalização da fatura, o cliente pode ver as instruções de pagamento na página da fatura hospedada. O URL da página da fatura hospedada é incluído na resposta da API como `hosted_invoice_url`. #### Japão Primeiro, você cria uma fatura. ```curl curl https://api.stripe.com/v1/invoices \ -u "<>:" \ -d "customer={{CUSTOMER_ID}}" \ -d "payment_settings[payment_method_types][]=customer_balance" \ -d collection_method=send_invoice \ -d days_until_due=30 ``` Em seguida, pode adicionar um ou mais itens de fatura à fatura. ```curl curl https://api.stripe.com/v1/invoiceitems \ -u "<>:" \ -d amount=1234 \ -d currency=jpy \ -d "customer={{CUSTOMER_ID}}" \ -d "description=Professional services" \ -d "invoice={{INVOICE_ID}}" ``` Em seguida, você pode finalizar a fatura. ```curl curl -X POST https://api.stripe.com/v1/invoices/{{INVOICE_ID}}/finalize \ -u "<>:" ``` Após a finalização da fatura, o cliente pode ver as instruções de pagamento na página da fatura hospedada. O URL da página da fatura hospedada é incluído na resposta da API como `hosted_invoice_url`. #### México Primeiro, você cria uma fatura. ```curl curl https://api.stripe.com/v1/invoices \ -u "<>:" \ -d "customer={{CUSTOMER_ID}}" \ -d "payment_settings[payment_method_types][]=customer_balance" \ -d collection_method=send_invoice \ -d days_until_due=30 ``` Em seguida, pode adicionar um ou mais itens de fatura à fatura. ```curl curl https://api.stripe.com/v1/invoiceitems \ -u "<>:" \ -d amount=1234 \ -d currency=mxn \ -d "customer={{CUSTOMER_ID}}" \ -d "description=Professional services" \ -d "invoice={{INVOICE_ID}}" ``` Em seguida, você pode finalizar a fatura. ```curl curl -X POST https://api.stripe.com/v1/invoices/{{INVOICE_ID}}/finalize \ -u "<>:" ``` Após a finalização da fatura, o cliente pode ver as instruções de pagamento na página da fatura hospedada. O URL da página da fatura hospedada é incluído na resposta da API como `hosted_invoice_url`. #### EUA Primeiro, você cria uma fatura. ```curl curl https://api.stripe.com/v1/invoices \ -u "<>:" \ -d "customer={{CUSTOMER_ID}}" \ -d "payment_settings[payment_method_types][]=customer_balance" \ -d collection_method=send_invoice \ -d days_until_due=30 ``` Em seguida, pode adicionar um ou mais itens de fatura à fatura. ```curl curl https://api.stripe.com/v1/invoiceitems \ -u "<>:" \ -d amount=1234 \ -d currency=usd \ -d "customer={{CUSTOMER_ID}}" \ -d "description=Professional services" \ -d "invoice={{INVOICE_ID}}" ``` Em seguida, você pode finalizar a fatura. ```curl curl -X POST https://api.stripe.com/v1/invoices/{{INVOICE_ID}}/finalize \ -u "<>:" ``` Após a finalização da fatura, o cliente pode ver as instruções de pagamento na página da fatura hospedada. O URL da página da fatura hospedada é incluído na resposta da API como `hosted_invoice_url`. ### Gerenciar pagamentos a mais ou a menos Com pagamentos por transferência bancária, é possível que o cliente envie a você mais ou menos do que o valor do pagamento esperado. Se o cliente enviar muito pouco, a Stripe financiará parcialmente um Payment Intent em aberto. As faturas não são parcialmente financiadas e permanecem abertas até que os fundos recebidos cubram o valor total da fatura. If the customer sends more than the expected amount, Stripe attempts to reconcile the incoming funds against an open payment and keep the remaining excess amount in the customer balance. Learn more about [how Stripe handles reconciliation](https://docs.stripe.com/payments/customer-balance/reconciliation.md). Quando um cliente paga parcialmente: Um cliente enviou uma transferência bancária com valor abaixo do esperado (See full diagram at https://docs.stripe.com/invoicing/bank-transfer) Quando um cliente paga em excesso: Um cliente enviou uma transferência bancária com valor acima do esperado (See full diagram at https://docs.stripe.com/invoicing/bank-transfer) ## Reconciliação automática de transferências Quando recebe uma transferência de entrada, a Stripe usa o código de referência, o valor e a data da transferência ao selecionar as faturas para reconciliação. ### Códigos de referência Normalmente, as transferências incluem uma observação, como: - *FATURA-0011* - *Pagamento da FATURA-0001* - *Pagamento para 001. Enviarei o cheque para 002 na próxima semana.* Quando a observação contém um número de fatura, a Stripe tenta antes reconciliar a transferência com a fatura mencionada. A Stripe só pode reconciliar transferências bancárias recebidas com faturas abertas ou vencidas com atraso inferior a 30 dias. ### Valor exato Depois de analisar os códigos de referência, a Stripe procura a fatura aberta mais antiga com valor exatamente igual ao valor transferido. Se ela for encontrada, a Stripe reconcilia a transferência com essa fatura. ### Várias faturas Se houver algum saldo restante, será possível que seu cliente tenha tentado pagar várias faturas com uma única transferência. A Stripe procura um grupo de faturas (cinco ou menos) em que o pagamento recebido corresponda ao total esperado. Se houver várias combinações possíveis, a Stripe selecionará a menor combinação. Se houver várias opções para a menor combinação, a Stripe selecionará a combinação que contém a fatura mais antiga. ### Fatura pagável mais antiga Quando há sobra de saldo, o cliente pode ter pago várias faturas com uma transferência ou transferido fundos adicionais. A Stripe paga progressivamente as faturas em aberto por data até esgotar o saldo ou as faturas disponíveis para pagamento. ### Falhas na reconciliação Quando fundos transferidos para a Stripe não são reconciliados com quaisquer [PaymentIntents](https://docs.stripe.com/api/payment_intents.md) ou faturas, os fundos são colocados no saldo do cliente e a Stripe envia o `cash_balance.funds_available` *webhook* (A webhook is a real-time push notification sent to your application as a JSON payload through HTTPS requests). ## Reconciliação manual Em certos casos, pode ser necessário [sobrepor o comportamento da reconciliação automática da Stripe](https://docs.stripe.com/payments/customer-balance/reconciliation.md#cash-manual-reconciliation) conforme o cliente. No modo de reconciliação manual, a Stripe não tenta reconciliar automaticamente os fundos recebidos, então você deve reconciliar manualmente todos os pagamentos. Saiba mais sobre a [aplicação manual do pagamento](https://docs.stripe.com/invoicing/apply-payments.md). ## Fundos de saldo em dinheiro não reconciliados Os fundos podem permanecer não reconciliados em um saldo de cliente, por exemplo, se um cliente enviar fundos em excesso e não houver faturas em aberto. Se o saldo de um cliente não for reconciliado por 75 dias, a Stripe tentará devolver automaticamente os fundos à conta bancária do cliente. Você pode ver a lista completa de clientes com [saldos de caixa não reconciliados](https://docs.stripe.com/payments/customer-balance/reconciliation.md#cash-unreconciled-funds) e a data da tentativa de devolução no [Dashboard](https://dashboard.stripe.com/test/customers?tab=remaining_balance). ## Confirmar titularidade da conta Seu cliente pode verificar seus dados bancários antes de iniciar uma transferência. Se ele solicitar a verificação da propriedade da conta (ou uma carta de verificação bancária), [baixe uma carta confirmando a propriedade da conta](https://docs.stripe.com/payments/cliente-balance/funding-instructions.md#vban-confirmation-letters). ## Pagamentos a menor O pagamento do seu cliente pode ser um pouco menor do que o valor necessário para pagar a fatura integralmente. Isso pode ser comum com transferências bancárias internacionais. Em vez de lidar manualmente com essas situações semelhantes, você pode definir um limite de pagamento menor abaixo do que você considera aceitável para fechar automaticamente a fatura e creditar ao cliente a diferença. Para definir essa configuração, acesse **Configurações** > **Billing** > [Faturas](https://dashboard.stripe.com/settings/billing/invoice). Em **Ajustes e reconciliação**, habilite **Abater faturas automaticamente**. ## Pagamentos parciais Se o seu cliente quiser pagar uma fatura com vários pagamentos, você poderá permitir que a Stripe reconcilie automaticamente os pagamentos recebidos por transferência bancária com faturas em aberto ou vencidas, mesmo que o valor da transferência não pague a fatura integralmente. Só tentaremos uma reconciliação parcial se o cliente fornecer um número de fatura na observação de transferência. Para definir essa configuração, acesse **Configurações** > **Billing** > [Faturas](https://dashboard.stripe.com/settings/billing/invoice). Em **Ajustes e reconciliação**, habilite **Reconciliar automaticamente pagamentos parciais por transferência bancária**. ## Instruções de pagamento Para cada cliente, a Stripe gera um número de conta bancária virtual único que aceita transferências na moeda da fatura. As instruções de transferência para essa conta bancária virtual são incluídas nas faturas para o cliente. Os dados de pagamento criados pela Stripe são: - **Único**: nenhum cliente tem o mesmo número de conta bancária. - **Consistente**: um único cliente recebe sempre as mesmas instruções de pagamento em várias faturas. - **Adequado para a moedas**: em países onde transferências bancárias são aceitas, a Stripe gera dados de conta bancárias locais (por exemplo, uma conta do Reino Unido para clientes no Reino Unido). - **Localizado para o cliente**: As instruções de pagamento mostradas em faturas consideram os [idiomas preferenciais do cliente](https://docs.stripe.com/invoicing/customize.md#customer-language), por isso, você pode localizar as instruções para cada cliente. Em alguns países, a Stripe também fornece um número de referência de transferência exclusivo para seu cliente incluir em cada transferência, ajudando a combiná-la com os pagamentos pendentes. Alguns países têm limites para o número de números de contas bancárias virtuais que você pode criar gratuitamente. Quando uma conta bancária virtual da Stripe recebe uma transferência, a Stripe reconcilia automaticamente os fundos para abrir faturas e cria um pagamento para pagar a fatura. ## Transferências reembolsadas Você pode reembolsar pagamentos concluídos diretamente para a conta bancária do cliente ou para o saldo do cliente no Stripe. Se você tiver habilitado a reconciliação automática e enviado fundos para o saldo do cliente, a Stripe tentará reconciliar os fundos automaticamente para abrir faturas. ## Testes Você pode [testar uma transferência de entrada de fundos](https://docs.stripe.com/payments/bank-transfers/accept-a-payment.md?payment-ui=direct-API#test-your-integration) no Dashboard ou usando o Stripe CLI.