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

Gerenciar contas de repasse para contas conectadas

Saiba como gerenciar contas bancárias externas e cartões de débito para contas conectadas.

As contas de Repasse podem ser contas bancárias ou cartões de débito. A Stripe recomenda coletar dados de contas externas com o formulário da web do Connect Onboarding , que ajuda você a:

  • Economize tempo de design e desenvolvimento.
  • Elimine a necessidade de armazenar dados sigilosos, como números de conta e routing numbers, no seu servidor.
  • Elimine a necessidade de criar validações de formulário quando os usuários inserem detalhes da conta.

Nos EUA, a Stripe recomenda usar o Stripe Financial Connections, o que permite que seus usuários vinculem com segurança suas contas financeiras ao seu negócio. Isso ajuda você a:

  • Aumente a conversão de onboarding, evitando que suas contas precisem interromper o processo para localizar números de conta e routing numbers.
  • Reduzir as taxas de falha no primeiro repasse, eliminando erros causados pela entrada manual de números de conta e routing numbers.
  • Elimine a necessidade de armazenar dados sigilosos, como números de conta e routing numbers, no seu servidor.
  • Elimine a necessidade de criar validações de formulário quando as contas inserem dados da conta em formulários de onboarding personalizados.
  • (Somente Accounts v1) Permita que suas contas façam a autenticação em menos etapas, reutilizando dados de contas bancárias salvos no Link. As contas que salvam os dados da conta em qualquer uma das empresas Stripe que usam o Link podem compartilhar os dados da conta com sua plataforma na próxima vez em que usarem o Financial Connections.
  • Acesse informações adicionais sobre a conta bancária externa de uma conta, como saldos, dados de propriedade e transações. Você pode mitigar fraudes durante o onboarding verificando esses dados, como o nome e o endereço do titular da conta bancária externa.

O Financial Connections é gratuito quando você inclui o Link. Caso contrário, o uso incorre em tarifas.

Por outro lado, se você usa o onboarding de API para suas contas conectadas, pode coletar dados da conta de repasses com um formulário personalizado no fluxo de onboarding de conta.

Cancelar a coleta de contas externas

Para contas nas quais a plataforma é responsável por coletar requisitos, como contas Custom, você pode optar por não coletar dados de contas externas durante o onboarding. Isso pode ser feito se, por exemplo, você criar seu próprio fluxo de onboarding onde deseja coletar dados de contas externas.

Na integração incorporada, você pode desabilitar a coleta de informações de contas externas definindo o recurso external_account_collection na Sessão da Conta como falso. Como alternativa, na integração hospedada, você pode acessar as Configurações de contas externas do Connect e, em Contas em que a plataforma é responsável por recolher requisitos, habilitar ou desabilitar a recolha de informações de contas externas. Observe que essa opção está desativada por padrão.

Coletar contas externas

O onboarding hospedado pela Stripe para contas conectadas usa um formulário da web hospedado pela Stripe para coletar os dados necessários para o onboarding de contas conectadas. O onboarding hospedado pela Stripe pode coletar contas bancárias e cartões de débito. Você pode usar o Financial Connections com o onboarding hospedado pela Stripe para coletar dados de conta bancária. No entanto, não é possível usar o Financial Connections para coletar dados de cartão de débito.

Se você é responsável por contas conectadas que não podem cobrir saldos negativos, incluindo contas Custom e Express, é possível personalizar o fluxo de cobrança de contas externas nas configurações da conta externa. Essas configurações não se aplicam se você estiver usando chamadas de API diretas no seu próprio formulário.

Nas configurações de Conta externa, você pode:

  • Ative ou desative a cobrança de cartões de débito fazendo uma seleção em Permitir cartões de débito?.
  • Exija que contas conectadas adicionem pelo menos uma conta bancária antes de poderem adicionar qualquer outro tipo de conta externa, como um cartão de débito. Você pode acessar essa configuração em Exigir pelo menos uma conta bancária?. Isso é útil para garantir o suporte ao débito automático.
  • Controle se as contas conectadas devem ou não adicionar mais de uma conta externa em uma determinada moeda. Há um limite de cinco contas externas por moeda. Acesse essa configuração em Cobrar várias contas externas por moeda.

Disponível em

Estados Unidos

As plataformas da Stripe nos EUA podem habilitar o Stripe Financial Connections dentro do formulário de onboarding hospedado pela Stripe, seguindo estas etapas:

  1. Acesse as configurações de conta externa, onde você gerencia recursos opcionais de onboarding do Connect.
  2. Para contas conectadas em que sua plataforma coleta dados da conta quando os requisitos mudam, incluindo contas Custom, você precisa permitir que o onboarding hospedado pela Stripe colete dados de conta externas. Em Onboarding hospedado pela Stripe para contas Custom, permita que a Stripe colete dados de contas externas ativando o botão.
  3. Em Como os dados da conta bancária serão coletados?, selecione Financial Connections.
  4. (Opcional) Solicite permissão para acessar dados adicionais nas contas verificadas instantaneamente com Financial Connections, como saldos, dados de propriedade e transações. Se optar por solicitar essas informações adicionais, você receberá uma solicitação para se inscrever no Stripe Financial Connections.

Quando a coleta externa de dados da conta está habilitada, todas as contas conectadas são solicitadas a autenticar sua conta bancária usando a IU do modal hospedada pela Stripe e integrada ao formulário de onboarding.

Imagem que mostra um fluxo do Connect Onboarding usando o Stripe Financial Connections para coletar uma conta de repasses.

Um fluxo de onboarding do Connect usando o Stripe Financial Connections para coletar uma conta de repasses.

Se uma conta conectada não puder verificar instantaneamente sua conta bancária usando o Financial Connections, o processo de verificação voltará automaticamente para a inserção manual:

Imagem que mostra um fluxo do Connect Onboarding usando o modal Stripe Financial Connections para coletar uma conta de repasse usando inserção manual.

Um fluxo de onboarding do Connect usando o modal Stripe Financial Connections para coletar uma conta de repasse usando inserção manual.

Após o onboarding, a conta bancária especificada é vinculada automaticamente à conta conectada.

Recuperar dados em uma conta do Financial Connections Server-side

Você pode determinar se o seu usuário vinculou uma conta do Financial Connections recuperando qualquer Conta do Financial Connections usando seu ID de conta conectada. Certifique-se de especificar o ID da sua conta no cabeçalho Stripe-Account.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl -G https://api.stripe.com/v1/financial_connections/accounts \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d "account_holder[account]"=
"{{CONNECTED_ACCOUNT_ID}}"

Isso retorna uma resposta de API semelhante a esta:

{
  "object": "list",
  "data": [
    {
      "id": "fca_zbyrdjTrwcYZJZc6WBs6GPid",
      "object": "financial_connections.account",
      "account_holder": {
        "account": 
"{{CONNECTED_ACCOUNT_ID}}"
,
        "type": "account"
      },
      ...
      "supported_payment_method_types": [
        "us_bank_account"
      ]
    }
    ...
  ]
}

Se alguma conta do Financial Connections estiver listada, isso indica que a conta conectada a vinculou durante o processo de onboarding. Você pode usar o valor id para acessar ou atualizar os dados que especificou nas configurações da conta externa. Para proteger a privacidade dos dados da sua conta conectada, você poderá acessar apenas os dados que especificou.

Para começar a recuperar dados de contas, siga os guias de saldos, propriedade e transações. Em todas as solicitações subsequentes de recuperação e atualização de conta, não se esqueça de incluir o cabeçalho Stripe-Account com o ID da conta conectada:

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/financial_connections/accounts/fca_zbyrdjTrwcYZJZc6WBs6GPid/refresh \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d "features[]"=balance

Permitir que contas conectadas atualizem suas contas externas

Quando uma conta conectada tenta atualizar sua conta externa (conta bancária ou cartão de débito), dados normalmente precisam fornecer detalhes sobre a conta externa existente ou verificar sua identidade. No entanto, algumas contas, especialmente as organizações sem fins lucrativos e contas de determinados planos de conformidade, podem não conseguir fazer isso. Por exemplo, a conta externa existente pode pertencer a um proprietário de conta anterior ou a Stripe pode não ter coletado determinados dados de identificação (como data de nascimento) durante o onboarding.

Se a sua plataforma for responsável por saldos negativos, você pode gerar um código único que permita que uma conta conectada atualize sua conta externa sem verificar sua identidade. Esse recurso só está disponível no modo de produção.

Você só pode gerar um código de atualização de conta externa quando sua plataforma é responsável por saldos negativos, o que exclui as contas que têm acesso completo ao Dashboard da Stripe. Se sua plataforma não for responsável por saldos negativos, uma conta conectada que deseja atualizar sua conta externa deve concluir a verificação padrão ou entrar em contato com o Suporte da Stripe.

Como funciona

Normalmente, quando uma conta conectada tenta atualizar sua conta externa no Dashboard Express, a Stripe solicita a inserção das informações da conta externa existente ou verifique sua identidade. No entanto, se você gerar um código de atualização de conta externa para uma conta conectada, a Stripe solicitará a inserção do código.

O código é válido por 7 dias. Caso ele expire antes que a conta conectada atualize sua conta externa, você poderá gerar outro código.

Gerar um código de atualização de conta externa

Quando você gera um código de atualização para uma conta conectada, sua plataforma aceita a responsabilidade jurídica e financeira exclusiva por quaisquer erros resultantes de alterações incorretas na conta externa. Antes de gerar um código, verifique a identidade da pessoa que solicita a alteração. Documente a solicitação de alteração, incluindo qualquer informação comprobatória.

Para gerar o código, siga estas etapas:

  1. No Dashboard da sua plataforma, navegue até a página Contas conectadas.
  2. Selecione a conta conectada que precisa atualizar a conta externa.
  3. Confirme se as informações do proprietário da conta estão corretas e correspondem às informações na solicitação de alteração.
  4. Na seção Informações de repasse, abra o menu de navegação () ao lado da conta externa e clique em Gerar código de atualização.
  5. Confirme as informações do proprietário da conta e aceite a responsabilidade.
  6. Clique em Enviar para enviar o código de atualização por e-mail ao proprietário da conta conectada.