Contas conectadas para débito
Ocasionalmente, a plataforma pode precisar coletar fundos de suas contas conectadas:
- Para cobrar produtos ou serviços da conta conectada
- Para recuperar fundos relacionados a um reembolso anterior
- Para fazer outros ajustes nos saldos de contas conectadas (por exemplo, corrigir um erro)
Ao criar e gerenciar contas conectadas onde sua plataforma é responsável por saldos negativos, incluindo contas Express ou Custom, você pode debitar o saldo da Stripe de uma conta conectada e transferir fundos para o saldo da sua plataforma.
Observação
Para faturar contas conectadas em que a Stripe é responsável pelos saldos negativos, crie um cliente para cada conta conectada e cobre-o usando assinaturas do Stripe Billing.
A Stripe aceita duas abordagens para isso:
- Cobrar uma conta conectada pelos produtos ou serviços da plataforma
- Transferir de uma conta conectada para recuperar fundos ou fazer outros ajustes
As duas abordagens criam o mesmo fluxo de fundos: um Transfer
é criado na conta conectada e um Payment
é criado na conta da plataforma.
Cuidado
O uso de débitos em conta exige consentimento legalmente vinculante de suas contas conectadas. Esse recurso está disponível para Austrália, Canadá, Europa, Hong Kong, Japão, Nova Zelândia e EUA. A Stripe aceita débitos em conta somente quando a plataforma e a conta conectada estão na mesma região (ambas no Japão, por exemplo). Se tiver interesse em outras regiões, fale com a equipe de vendas. O uso de débitos em conta incorre um custo adicional.
Requisitos
Esta função só é aceita para contas conectadas em que sua plataforma é responsável por saldos negativos, incluindo contas Express e Custom. Além disso:
- A conta conectada e a plataforma precisam estar na mesma região (ou seja, ambas na Europa ou nos EUA).
- O valor de
currency
precisa corresponder à moeda padrão da conta conectada. - O débito não pode deixar o saldo da conta negativo, a não ser que você tenha reservas ativadas (opção ativada por padrão em todas as novas plataformas criadas depois de 31 de janeiro de 2017) e tenha uma conta bancária na mesma moeda do débito.
- Se uma conta conectada tiver saldo negativo, a Stripe poderá debitar automaticamente a conta externa cadastrada, dependendo do país de domicílio da conta conectada.
Evite contratempos ao verificar o banco da conta conectada antes de usar débitos em conta.
Cobrar uma conta conectada
A chamada de API para criar uma cobrança aceita a especificação de um ID de conta conectada como valor de source
:
A chamada de API retorna o Payment
criado na conta da plataforma (nota: ela não retorna um Charge
).
Essa abordagem é adequada para plataformas que cobram de contas conectadas mercadorias e serviços (ou seja, o uso da plataforma). Por exemplo, uma plataforma pode cobrar tarifas ou serviços adicionais do saldo da Stripe de contas conectadas, reduzindo a necessidade de coletar mais uma forma de pagamento e disponibilizando os fundos de forma praticamente instantânea.
Transferir de uma conta conectada
O segundo método para debitar uma conta conectada é transferir da conta conectada para a conta da sua plataforma. Use o cabeçalho Stripe-Account
para autenticar como a conta conectada e informe o ID da conta Stripe da plataforma em destination
:
Esta chamada de API retorna o Transfer
criado na conta conectada.
Esta abordagem é mais adequada para ajustes em uma plataforma (por exemplo, corrigir um pagamento equivocado ou recuperar tarifas pagas à Stripe).
Para executar essa solicitação, você precisa do ID da conta Stripe da plataforma. Se você ainda não tem esse valor, execute uma chamada de API para acessar a conta usando a chave de API da plataforma:
Essa chamada de API retorna um objeto Account
que representa a conta da plataforma.