Saldos de conta do Connect

A conta da sua plataforma e uma conta conectada são contas Stripe, cada uma com seu próprio saldo.

Todas as contas da Stripe têm saldos em dois estados:

• pending indica que os fundos ainda não estão disponíveis para repasse
• available indica que os fundos já podem ser repassados

No caso de contas que não são Connect, o processamento de cobranças aumenta o saldo da conta Stripe. O valor cobrado, menos as taxas da Stripe, aparece inicialmente no saldo pendente e se torna disponível em 2 dias de forma contínua (esse tempo varia conforme o país e a conta). Os fundos disponíveis podem ser depositados em uma conta bancária ou cartão de débito. Os repasses reduzem o saldo da conta Stripe no valor correspondente.

Com o Connect, sua conta de plataforma e cada conta conectada tem seus próprios saldos pending e available. A alocação de fundos entre elas depende do tipo de cobranças utilizada.

Além disso, uma conta de plataforma também pode ter um saldo connect_reserved, usado para compensar saldos negativos em contas conectadas.

Verifique o saldo de uma conta conectada

Para verificar o saldo de uma conta conectada, faça a chamada autenticada obter saldo como a conta conectada. O objeto Balance reflete os saldos pending e available.

curl https://api.stripe.com/v1/balance \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
"

Contabilidade de saldos negativos

Some actions, such as refunds and chargebacks, create negative transactions in a Stripe account. Stripe handles negative transactions to help maintain a positive Stripe balance for related accounts:

• Quando possível, a Stripe compensa automaticamente transações negativas com pagamentos futuros
• Primeiro, a Stripe atribui transações negativas à conta onde a cobrança foi feita. Por exemplo: se a cobrança foi feita por uma conta conectada, os reembolsos e estornos saem da conta conectada. Se a cobrança foi feita pela plataforma, os reembolsos e estornos saem da conta da plataforma.

Apesar dessas medidas, se o saldo de uma conta conectada se tornar negativo, a responsabilidade final depende da propriedade da conta controller.losses.payments property:

• stripe (inclusive contas Standard): a conta conectada é responsável por cobrir seus próprios saldos negativos da Stripe.
• application (incluindo contas Express e Custom): a plataforma é responsável por cobrir os saldos negativos da conta Stripe.

Quando o saldo de uma conta conectada fica negativo, a Stripe debita fundos da conta externa cadastrada até o máximo permitido de tentativas de débito. Se todas as tentativas falharem, os repasses para a conta externa são suspensos e essa conta é debitada até que a conta externa cadastrada seja atualizada.

Enquanto o saldo de uma conta estiver negativo, você não pode enviar repasses para o banco ou cartão de débito da conta no nome dela. A Stripe retomará o envio de repasses para a conta conectada quando o saldo da conta Stripe estiver positivo novamente.

Debitar automaticamente contas conectadas

Se a Stripe ainda não tiver tentado debitar um saldo negativo de uma conta externa conectada, defina debit_negative_balances como true para permitir que a Stripe faça isso automaticamente.

O débito automático para saldos negativos é aceito por bancos nos seguintes países:

• Austrália
• Canadá
• Países que aceitam (SEPA na Europa, incluindo o Reino Unido)
• Nova Zelândia
• Estados Unidos

Consulte as perguntas frequentes sobre débito automático para obter uma descrição detalhada dos países e tipos de conta aceitos.

Habilitar debit_negative_balances aciona débitos conforme a necessidade, mesmo quando a conta conectada está em repasses manuais. Para obter mais detalhes, consulte Impacto de estornos e saldos negativos.

Saldos de reserva de contas conectadas

Para se proteger contra saldos negativos available da conta conectada pelos quais sua plataforma é responsável, a Stripe retém uma reserva no saldo available da conta da sua plataforma. Dependendo do país da conta conectada, a Stripe inicia uma retirada de fundos da conta bancária da conta para cobrir o saldo negativo. O saldo available da conta é zerado assim que o valor retirado é depositado, mas a reserva da plataforma nessa conta é mantida por mais três dias úteis. Essa reserva aparece no Dashboard e nos relatórios exportados (como transação de reserva).

Existem três tipos de atividades de saldo relacionadas a reservas:

• Fundos reservados para cobrir um saldo negativo de uma conta conectada. Quando o saldo de uma conta conectada fica negativo, a Stripe reserva temporariamente uma parte do seu saldo para garantir que os fundos sejam cobertos, criando uma transação de saldo do tipo reserve_transaction.
• Fundos liberados após uma alteração de saldo positivo em uma conta conectada. Quando o saldo negativo de uma conta conectada fica menos negativo devido a uma atividade na conta (por exemplo, após novas cobranças), a parte correspondente do saldo de reserva da sua plataforma é liberada em uma transação de saldo do tipo reserve_transaction.
• Fundos coletados devido a um saldo negativo por longo período em uma conta conectada. Quando uma conta conectada mantém um saldo negativo por 180 dias, a Stripe transfere uma parte do seu saldo para zerar o saldo da conta ao criar uma transação de saldo do tipo connect_collection_transfer.

Para ver as reservas mantidas atualmente em sua conta, faça uma chamada de API de acesso ao saldo da sua própria conta (ou seja, não autorizado como outro usuário, como no exemplo acima).

Para eliminar o saldo negativo de uma conta conectada e, assim, remover a reserva na sua conta, faça uma transferência para a conta em questão. Se uma conta conectada mantiver um saldo negativo por mais de 180 dias, a Stripe transferirá automaticamente suas reservas para a conta conectada para zerar o saldo. As páginas e relatórios do Dashboard exibem essas transferências como transferências de cobrança do Connect.

Retenção de fundos

Se precisar de um controle mais detalhado sobre o agendamento de repasses para contas conectadas quando sua plataforma é responsável por saldos negativos, você pode usar uma das seguintes abordagens:

• Reter fundos no saldo da plataforma antes de transferi-los para o saldo de uma conta conectada
• Reter fundos no saldo de uma conta conectada antes de repassá-los para uma conta externa

Recomendamos às plataformas que retenham os fundos somente se houver um motivo claro para a retenção e o compromisso de fazer o pagamento assim que um evento ocorrer ou uma condição for atendida. O caso de uso típico para a retenção de fundos é o das plataformas de serviços sob demanda, em que o marketplace normalmente aguarda o serviço ser concluído e confirmado para pagar o prestador (como locações, serviços de entrega e transporte compartilhado).

As plataformas devem evitar reter fundos de forma arbitrária e procurar fazer os repassas para as contas conectadas assim que estas forem identificadas. Isso normalmente ocorre quando a cobrança é feita. Se você não tiver certeza sobre a retenção de fundos, fale com um advogado.

Por motivos de conformidade, podemos manter fundos em reserva por um período baseado no país do comerciante, como mostrado abaixo: