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)

Quando sua plataforma é responsável por saldos negativos, como no caso de contas conectadas Express e Custom, você pode debitar o saldo da Stripe de uma conta conectada e transferir fundos para o saldo da sua plataforma.

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.

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 conectada 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 pode debitar automaticamente a conta externa cadastrada, dependendo do país de domicílio da conta. Se a conta externa não tiver sido verificada, o débito pode falhar.
• O amount máximo é 100.000 USD (ou equivalente na sua moeda).

Cobrar uma conta conectada

A criação de uma chamada da API de cobrança aceita o fornecimento de um ID de conta conectada como valor de source:

curl https://api.stripe.com/v1/charges \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d amount=1500 \
  -d currency=usd \
  -d source=
{{CONNECTED_ACCOUNT_ID}}

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:

curl https://api.stripe.com/v1/transfers \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d amount=1500 \
  -d currency=usd \
  -d destination={{PLATFORM_STRIPE_ACCOUNT_ID}}

Esta chamada de API retorna o Transfercriado na conta conectada.

Esta abordagem é mais adequada para ajustes em uma plataforma (por exemplo, corrigir um pagamento equivocado ou recuperar tarifas pagas à Stripe).