Usar o Connect com contas conectadas Standard

Use the Create Account API to create a connected account with type set to standard. You can prefill any information, but at a minimum, you must specify the type. The country of the account defaults to the same country as your platform, and the account confirms the selection during onboarding. If you know what capabilities the account needs, you can request them when you create it.

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

If you’ve already collected information for your connected accounts, you can prefill that information on the Account object. You can prefill any account information, including personal and business information, external account information, and so on.

Connect Onboarding doesn’t ask for the prefilled information. However, it does ask the account holder to confirm the prefilled information before accepting the Connect service agreement.

When testing your integration, prefill account information using test data.

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.