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.
Permita que suas contas façam a autenticação em menos etapas, reutilizando dados de contas bancárias salvos no Link. Contas que salvam os dados da conta em qualquer empresa da Stripe usando 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.

No onboarding integrado, você pode desativar a coleta de contas externas definindo o recurso external_account_collection na Sessão da conta como falso. No onboarding hospedado, você pode acessar as configurações de contas externas do Connect e depois, em Contas nas quais a plataforma é responsável por coletar requisitos, ativar ou desativar a coleta de dados de contas externas. Observe que isso está desativado 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:

Acesse as configurações de conta externa, onde você gerencia recursos opcionais de onboarding do Connect.
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.
Em Como os dados da conta bancária serão coletados?, selecione Financial Connections.
(Opcional) Solicite permissão para acessar dados adicionais sobre as contas verificadas instantaneamente com conexões financeiras, como saldos, detalhes 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.

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: