Pular para o conteúdo
Criar conta ou Entrar
O logotipo da documentação da Stripe
/
Criar contaLogin

Pagar para contas conectadas

Gerencie os repasses para as contas conectadas do marketplace.

Por padrão, qualquer charge que você faz em nome de um conta conectada se acumula na conta conectadasaldo e é pago diariamente. Dependendo da configuração de suas contas conectadas, você pode gerenciar seus payouts da seguinte forma:

Você pode usar o Dashboard ou a API Balance Settings.

Frequência de repasses

Por padrão, todos os fundos que você transfere para uma conta conectada se acumulam no saldo Stripe da conta conectada e são pagos diariamente, de forma contínua. Para alterar a frequência de repasses de uma conta conectada, use o Dashboard ou a API.

Use a API Configurações do saldo.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/balance_settings \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d "payments[payouts][schedule][interval]"=weekly \
  -d "payments[payouts][schedule][weekly_payout_days][]"=monday \
  -d "payments[payouts][schedule][weekly_payout_days][]"=wednesday

Ofereça repasses mais rápidos

Os marketplaces costumam fazer repasses aos comerciantes com mais frequência. Você pode permitir que suas contas conectadas acessem seus saldos imediatamente após uma transação bem-sucedida, oferecendo Instant Payouts. Instant Payouts estão disponíveis a qualquer dia e hora, incluindo fins de semana e feriados, e os fundos costumam ser compensados na conta bancária associada em até 30 minutos. Você pode obter receita adicional cobrando uma tarifa pelo recebimento de Instant Payouts.

Configurações de gerenciamento de repasses

Para contas conectadas com acesso ao Stripe Dashboard ou ao Dashboard Express completos, o titular da conta gerencia suas contas externas de repasses (contas bancárias e cartões de débito), mas a plataforma pode agendar os repasses. Para agendar repasses para uma conta que tem acesso ao Stripe Dashboard completo, a plataforma deve configurar controles de plataforma para a conta.

Para contas conectadas sem acesso a um Dashboard hospedado pela Stripe, a plataforma gerencia suas contas de repasse externas e pode agendar os repasses.

API Accounts v2

A API Accounts v2 não aceita diretamente o hash external_accounts. Quando usar v2, use endpoints /v1/accounts para gerenciar external_accounts.

Moedas de liquidação de fundos aceitas

Selecione um país no menu suspenso a seguir para ver as moedas nas quais você deve pagar os fundos quando a conta bancária externa da sua conta conectada estiver nesse país.

Nota

Para obter uma lista das moedas de apresentação aceitas, consulte a documentação sobre moedas.

Carregando uma tabela de moedas de repasse do Connect

Você também pode permitir que suas contas conectadas liquidem fundos e façam repasses para bancos em determinadas moedas não primárias, ou façam repasses para contas bancárias não domésticas na moeda local. Em alguns casos, a Stripe cobra uma tarifa. Para mais informações, consulte liquidação de fundos multimoedas para marketplaces e plataformas Connect.

Acompanhe os repasses com Webhooks

Você pode acompanhar toda a atividade de repasses em contas conectadas com webhooks criando um destino de evento e escutando estes eventos:

  • payout.created
  • payout.updated
  • payout.paid
  • payout.failed

API Accounts v2

Repasses não acionam eventos v2, acionam apenas os eventos v1 descritos aqui.

Para a maioria dos repasses, as notificações de eventos ocorrem em diversos dias. Os repasses instantâneos geralmente enviam payout.paid em até 30 minutos.

Quando não é possível concluir um repasse, ocorre um evento payout.failed. A propriedade failure_code do evento indica o motivo. Uma falha de repasse também desativa a conta externa envolvida nesse repasse, acionando um evento account.external_account.updated. Nenhum repasse pode ser feito para essa conta externa até que a plataforma atualize as contas externas da conta conectada.

Próximas etapas

Em seguida, saiba como lidar com reembolsos e contestações.