Usar o Connect com contas conectadas Standard

Use a API Create Account para criar uma conta conectada com type definido como standard. Você pode preencher qualquer informação, mas no mínimo deve especificar o type. O país da conta é definido automaticamente como o mesmo país da sua plataforma e a conta confirma a seleção durante o onboarding. Se você souber de quais funções a conta precisa, pode solicitá-las quando criá-la.

curl https://api.stripe.com/v1/accounts \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d type=standard

Se você já coletou dados de suas contas conectadas, pode usá-los para preencher o objeto Account. Você pode preencher quaisquer dados de conta, inclusive dados pessoais e comerciais, dados de contas externas e muito mais.

O Connect Onboarding não solicita as informações pré-preenchidas. No entanto, ele solicita que o titular da conta confirme as informações pré-preenchidas antes de aceitar o contrato de serviços do Connect.

Ao testar sua integração, preencha antecipadamente os dados da conta usando dados de teste.

Você pode criar um link de conta chamando a API Account Links com os seguintes parâmetros:

• account - use o ID da conta retornado pela API na etapa anterior
• refresh_url
• return_url
• type = account_onboarding

curl https://api.stripe.com/v1/account_links \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d account=
{{CONNECTED_ACCOUNT_ID}} \
  --data-urlencode refresh_url="https://example.com/reauth" \
  --data-urlencode return_url="https://example.com/return" \
  -d type=account_onboarding

A resposta à sua solicitação de Account Links inclui um valor para a chave url. Redirecione para esse link para enviar seu usuário ao fluxo. Você só pode usar URLs da API Account Links uma vez porque concedem acesso aos dados pessoais do titular da conta. Autentique o usuário no seu aplicativo antes de redirecioná-lo para esse URL. Após criar um link de conta em uma conta Standard, você não poderá ler ou escrever informações de Know Your Customer (KYC). Faça o preenchimento prévio de informações de KYC antes de criar o primeiro link de conta.

O Connect Onboarding exige a passagem de return_url e refresh_url para gerenciar todos os casos em que você redireciona o usuário à sua plataforma. É importante implementá-los corretamente para proporcionar a melhor experiência ao usuário.

return_url

A Stripe emite um redirecionamento para este URL quando o usuário conclui o fluxo do Connect Onboarding. Isso não significa que todas as informações foram coletadas ou que não há requisitos pendentes na conta. Significa somente que a entrada e saída do fluxo foram normais.

Nenhum estado é passado através deste URL. Após redirecionar um usuário para o return_url, verifique o estado do parâmetro details_submitted na conta dele, realizando uma das seguintes ações:

• Escutar webhooks account.updated
• Chamar a API Accounts e inspecionar o objeto retornado.

refresh_url

O usuário é redirecionado para refresh_url nestes casos:

• O link expirou (alguns minutos se passaram desde a criação do link)
• O usuário já acessou o link (atualizou a página ou clicou em Voltar ou Avançar no navegador)
• Sua plataforma não consegue mais acessar a conta
• A conta foi recusada

O refresh_url aciona um método no servidor para chamar novamente a API Account Links com os mesmos parâmetros e redirecionar o usuário ao fluxo do Connect Onboarding para criar uma experiência ideal.

Um usuário que é redirecionado para o seu return_url pode não ter concluído o processo de onboarding. Use o endpoint /v1/accounts para recuperar a conta do usuário e verificar charges_enabled. Se a conta não estiver totalmente integrada, forneça solicitações de IU para permitir que o usuário continue o onboarding mais tarde. O usuário pode concluir a ativação da conta por meio de um novo link de conta (gerado por sua integração). Verifique o estado do parâmetro details_submitted na conta dele para ver se o processo de onboarding foi concluído.