# Usar o Connect com contas conectadas Standard Use contas conectadas Standard para começar a usar o Connect imediatamente e deixe a Stripe gerenciar a maior parte da experiência com contas conectadas. > #### Novas integrações do Connect > > As informações nesta página se aplicam apenas a plataformas que já utilizam tipos de contas conectadas antigas. Se você estiver configurando uma nova plataforma Connect ou se sua integração utilizar a API Accounts v2, consulte [Configurar o comportamento das contas conectadas](https://docs.stripe.com/connect/accounts-v2/connected-account-configuration.md) para saber mais sobre as configurações das contas conectadas. Se sua integração utilizar a API Accounts v1, consulte [Propriedades do controlador de contas](https://docs.stripe.com/connect/migrate-to-controller-properties.md#account-controller-properties). O processo descrito aqui é o método recomendado para criar contas Standard. Se você é uma extensão ou aplicativo que precisa acessar uma conta existente para prestar serviços aos usuários, pode usar o [OAuth](https://docs.stripe.com/connect/oauth-reference.md). Uma conta conectada *Standard* é uma conta Stripe convencional em que sua conta conectada tem um relacionamento com a Stripe, pode acessar o [Dashboard](https://dashboard.stripe.com) e pode processar cobranças por conta própria. O exemplo de integração da Stripe, [Kavholm](https://github.com/stripe-samples/connect-onboarding-for-standard), mostra como usar o [Connect Onboarding](https://stripe.com/connect/onboarding) para oferecer uma experiência integrada de onboarding de usuários. ![Captura de tela do formulário do Connect Onboarding](https://b.stripecdn.com/docs-statics-srv/assets/Kavholm-Seamless-Standard.78b64d90c0bf87130c8b6ba1ef53df7f.png) ## Como usar o Connect Onboarding para contas Standard 1. Acesse a [página de configurações do Connect](https://dashboard.stripe.com/account/applications/settings) para personalizar a aparência do formulário com o nome, a cor e o ícone da sua marca. O Connect Onboarding exige esses dados. 1. Use a API `/v1/accounts` para [criar](https://docs.stripe.com/api/accounts/create.md) uma conta e obter o ID associado. É possível preencher os dados no objeto da conta para o usuário antes de gerar o link para a conta. Você precisa passar o seguinte parâmetro: - `type` = `standard` > Depois de criar a conta, verifique se ela é exibida no Dashboard. 1. Chame a API [Account Links](https://docs.stripe.com/api/account_links.md) para criar um link para a conta que fará onboarding. 1. No fluxo de onboarding da sua plataforma, redirecione o usuário para o `url` retornado pela API [Account Links](https://docs.stripe.com/api/account_links.md). 1. Processe estados de conta adicionais, redirecionando sua conta para o fluxo do Connect Onboarding, se necessário. 1. *Opcional*: você pode adicionar outros procedimentos, como Tax ou Climate, ao fluxo do Connect Connect Onboarding usando as [opções do Connect Onboarding](https://dashboard.stripe.com/settings/connect/onboarding-options) no Dashboard. ## Crie uma conta Standard e preencha os dados Use a API [Create Account](https://docs.stripe.com/api/accounts/create.md) 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](https://docs.stripe.com/connect/account-capabilities.md) a conta precisa, pode solicitá-las quando criá-la. > Este exemplo inclui apenas alguns dos campos que você pode definir ao criar uma conta. Para obter uma lista completa dos campos que você pode definir, como `address` e `website_url`, consulte a [referência da API Criar conta](https://docs.stripe.com/api/accounts/create.md). ```curl curl https://api.stripe.com/v1/accounts \ -u "<>:" \ -d type=standard ``` ### Preencher informações antecipadamente (Opcional) 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. Depois de criar uma `Account`, crie uma [Pessoa](https://docs.stripe.com/api/persons/create.md) para representar a pessoa responsável por abrir a conta, com `relationship.representative` definido como verdadeiro e informações da conta que você queira preencher previamente (por exemplo, o nome e sobrenome). ```curl curl https://api.stripe.com/v1/accounts/{{ACCOUNT_ID}}/persons \ -u "<>:" \ -d first_name=Jenny \ -d last_name=Rosen \ -d "relationship[representative]=true" ``` 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](https://docs.stripe.com/connect/service-agreement-types.md). Ao testar sua integração, preencha antecipadamente os dados da conta usando [dados de teste](https://docs.stripe.com/connect/testing.md). ## Crie um link da conta Você pode criar um link de conta chamando a API [Account Links](https://docs.stripe.com/api/account_links.md) 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 curl https://api.stripe.com/v1/account_links \ -u "<>:" \ -d "account={{CONNECTEDACCOUNT_ID}}" \ --data-urlencode "refresh_url=https://example.com/reauth" \ --data-urlencode "return_url=https://example.com/return" \ -d type=account_onboarding ``` ## Redirecione o usuário ao URL do link da conta A resposta à sua solicitação de [Account Links](https://docs.stripe.com/api/account_links.md) 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](https://docs.stripe.com/api/account_links.md) 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](https://support.stripe.com/questions/know-your-customer) (KYC). Faça o preenchimento prévio de informações de KYC antes de criar o primeiro link de conta. > Não envie URLs de links de conta por e-mail, SMS ou outra maneira para fora do aplicativo da sua plataforma. Em vez disso, forneça-os ao titular da conta autenticado dentro do seu aplicativo. ## Gerencie o usuário que volta à plataforma 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. > Você pode usar HTTP para seu `return_url` e para o `refresh_url` enquanto estiver em um ambiente de teste (por exemplo, para testar com o localhost), mas você só pode usar HTTPS no modo de produção. Você deve atualizar URLs de teste para URLs HTTPS antes do lançamento. #### 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* (A webhook is a real-time push notification sent to your application as a JSON payload through HTTPS requests) `account.updated` - Chamar a API [Accounts](https://docs.stripe.com/api/accounts.md) 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](https://docs.stripe.com/api/account_links.md) com os mesmos parâmetros e redirecionar o usuário ao fluxo do Connect Onboarding para criar uma experiência ideal. ## Gerencie usuários que não concluíram o onboarding 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. ## Optional: Ativar monitoramento de obrigação do Stripe Tax Use o Stripe Tax para permitir que contas conectadas monitorem suas [obrigações fiscais](https://docs.stripe.com/tax/monitoring.md) durante o processamento de pagamentos. A Stripe envia [notificações](https://docs.stripe.com/tax/monitoring.md#tax-threshold-notifications) a essas contas quando elas excedem limites fiscais específicos. Para habilitar o monitoramento de obrigações, ative o Stripe Tax nas suas [opções do Connect Onboarding](https://dashboard.stripe.com/settings/connect/onboarding-options). Isso permite uma etapa adicional que solicita dados fiscais básicos, como o [código fiscal predefinido](https://docs.stripe.com/tax/products-prices-tax-codes-tax-behavior.md#product-tax-code), que aparece durante o processo de onboarding para contas conectadas com acesso ao Stripe Dashboard. O Stripe Tax usa esses dados para calcular quando os limites fiscais podem ser ultrapassados. Saiba como [recolher impostos como plataforma](https://docs.stripe.com/tax/connect.md). ## See also - [Criar cobranças](https://docs.stripe.com/connect/charges.md) - [Autenticação](https://docs.stripe.com/connect/authentication.md) - [Referência do OAuth](https://docs.stripe.com/connect/oauth-reference.md)