# Crie uma integração avançada do Connect usando a API Accounts v1 Saiba mais sobre combinações alternativas de configuração para uma integração do Connect com base na API Accounts v1. > #### Integrações da API Accounts v2 > > Este guia se aplica apenas às plataformas Connect existentes que utilizam a API Accounts v1. Se você é um novo usuário do Connect, utilize a API Accounts v2. Consulte o [Guia da plataforma interativa](https://docs.stripe.com/connect/interactive-platform-guide.md) para obter informações sobre como configurar uma plataforma Connect utilizando a API Accounts v2. Use este guia para explorar as diferentes integrações do Connect e criar uma lista de etapas de integração personalizadas. Antes de iniciar sua integração em um ambiente de *área restrita* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes), você deve [criar uma conta Stripe ou fazer login](https://dashboard.stripe.com) e [fazer onboarding da plataforma para o Connect](https://dashboard.stripe.com/settings/connect/platform-profile). ## Selecionar propriedades ### Criar e fazer onboarding de contas A Stripe permite criar contas em nome dos usuários, chamadas de contas conectadas. Ao usar o Connect, você cria contas conectadas para cada usuário que recebe dinheiro na sua plataforma. #### Item 1 Envie as contas conectadas a um fluxo de onboarding hospedado pela Stripe. O onboarding hospedado pela Stripe permite que você redirecione seu usuário à Stripe para concluir o processo de onboarding em uma interface de marca conjunta. ![Captura de tela do formulário do Connect Onboarding](https://b.stripecdn.com/docs-statics-srv/assets/Kavholm-Seamless-Standard.78b64d90c0bf87130c8b6ba1ef53df7f.png) Ideal para lançamentos rápidos com o mínimo esforço de integração: - As contas conectadas saem do seu site e são redirecionadas à Stripe para concluir o fluxo. - Co-branding com a Stripe e opções limitadas para personalizar. - A Stripe lida com toda a lógica do fluxo de onboarding. - Aceita automaticamente mais de 46 países e 14 idiomas. #### Item 2 Incorpore uma IU de onboarding altamente temática com marca limitada da Stripe diretamente no seu aplicativo. Os usuários de contas conectadas interagem com o componente integrado sem sair do seu aplicativo. Você pode integrar o onboarding integrado em apenas algumas linhas de código. Note: The following is a preview/demo component that behaves differently than live mode usage with real connected accounts. The actual component has more functionality than what might appear in this demo component. For example, for connected accounts without Stripe dashboard access (custom accounts), no user authentication is required in production. Ideal para quando você quer manter os usuários em seu site com uma experiência mais integrada e um baixo esforço de integração: - As contas conectadas permanecem no seu site. - Altamente temático. Limitado a nenhuma marca da Stripe. - A Stripe lida com toda a lógica do fluxo de onboarding. - Aceita automaticamente mais de 46 países e 14 idiomas. #### Item 3 Desenvolva cada aspecto do fluxo de onboarding chamando as APIs da Stripe correspondentes. Você precisa criar uma lógica personalizada em sua integração para atender a todos os dados de verificação necessários. > #### Recomendação da Stripe > > Criar e manter um fluxo de onboarding de API consome muitos recursos e exige atualizações regulares. Se quiser implementar um fluxo de onboarding personalizado, a Stripe recomenda enfaticamente o uso do [onboarding integrado](https://docs.stripe.com/connect/embedded-onboarding.md). (See full diagram at https://docs.stripe.com/connect/design-an-integration) Ideal para quem deseja controle total do fluxo de onboarding: - Crie e mantenha sua própria lógica de fluxo de onboarding. Pode consumir muitos recursos e ser caro de construir. - Você gerencia riscos com total responsabilidade em caso de obrigações com saldos negativos em contas conectadas. - Você precisa manter seus fluxos atualizados à medida que os requisitos de verificação mudam e criar fluxos adicionais para comunicar e coletar esses requisitos dos seus usuários. Revise e atualize os requisitos de onboarding pelo menos a cada seis meses para garantir que os requisitos mais recentes sejam incorporados ao seu fluxo. - Você deve criar um formulário personalizado para coletar contas bancárias ou cartões de débito para que as contas conectadas possam ser configuradas com uma conta de repasse. ### Configurar fluxos do Dashboard Contas conectadas precisam de acesso a um Dashboard para gerenciar suas contas. Forneça às contas conectadas acesso ao Stripe Dashboard, ao Dashboard Express ou a um dashboard criado com a API da Stripe e componentes integrados. #### Item 1 Forneça acesso ao Stripe Dashboard para contas conectadas. O Stripe Dashboard fornece às contas conectadas um conjunto completo de funções, incluindo visualização de repasses, gerenciamento de reembolsos, processamento de contestações, acesso a relatórios e processamento de cobranças por conta própria. Os usuários podem entrar no Stripe Dashboard a qualquer momento e acessar o Dashboard acessando a Stripe diretamente. Os usuários têm acesso ao suporte da Stripe, e a Stripe pode entrar em contato e se comunicar com os usuários sobre as contas deles. Use o Stripe Dashboard quando: - Seus usuários precisam de acesso a fluxos avançados de pagamento e recursos avançados de gerenciamento de usuários. - Você prefere que a Stripe gerencie o risco de perda e assuma a responsabilidade por saldos negativos nas contas conectadas. - Você está confortável com a marca Stripe e o co-branding limitado da plataforma. Você também pode adicionar [componentes integrados](https://docs.stripe.com/connect/get-started-connect-embedded-components.md) ao seu próprio site para fornecer acesso ao Stripe Dashboard. #### Item 2 Forneça acesso ao Dashboard Express para que as contas conectadas gerenciem suas contas. O Dashboard Express permite que contas conectadas visualizem seu saldo disponível, vejam os próximos repasses e acompanhem suas receitas em tempo real. Os usuários não podem gerenciar reembolsos ou contestações no Dashboard Express. Os usuários têm acesso ao suporte da Stripe, e a Stripe pode entrar em contato e se comunicar com os usuários sobre as contas deles. Use o Dashboard Express quando: - Seus usuários são vendedores de um marketplace que precisam de acesso limitado aos fluxos de trabalho. - Você envia repasses principalmente para esses usuários. Os usuários não gerenciarão reembolsos ou contestações diretamente. - Você quer personalizar totalmente a aparência do dashboard. - Você está confortável em assumir a responsabilidade por saldos negativos e em gerenciar o risco de perda nas contas conectadas. Você sempre pode adicionar [Componentes integrados do Connect](https://docs.stripe.com/connect/get-started-connect-embedded-components.md) ao seu próprio site, além de fornecer acesso ao Stripe Dashboard. #### Item 3 Crie um painel usando APIs da Stripe ou componentes integrados para permitir que as contas conectadas gerenciem as próprias contas. As contas conectadas não terão acesso ao Stripe Dashboard ou Dashboard Express. Você é responsável por fornecer acesso a esses fluxos de trabalho criando o Dashboard, os fluxos de trabalho de reembolsos, os fluxos de trabalho de contestações e as funções de relatórios do usuário. Talvez seus usuários não percebam que têm uma conta Stripe por meio da sua plataforma. Recomendamos a integração de [Componentes integrados do Connect](https://docs.stripe.com/connect/get-started-connect-embedded-components.md) para adicionar funcionalidade de dashboard ao seu aplicativo de plataforma com baixo esforço de integração. Os componentes integrados são altamente personalizáveis e podem oferecer suporte a contas conectadas com: - Fluxos de trabalho de pagamentos, como visualização de pagamentos e repasses, gerenciamento de reembolsos e resposta a contestações. - Fluxos de trabalho de repasses, como gerenciamento de cronogramas de repasses, criação de repasses manuais ou atualização de contas de repasses - Fluxos de trabalho de relatórios para baixar e exportar pagamentos e repasses - Fluxos de trabalho de gerenciamento de contas, como atualização de dados comerciais > Para uma conta sem acesso ao dashboard hospedado pela Stripe, em que a Stripe é responsável por saldos negativos, use os componentes integrados do Connect para fornecer atualizações de conta por autoatendimento. Não é possível criar [Links de conta](https://docs.stripe.com/api/account_links.md) do tipo `account_update` para essas contas. ### Aceitar um pagamento Você cria uma cobrança para aceitar um pagamento de um cliente em nome da sua conta conectada. O tipo de cobrança criada: - Determina como os fundos de pagamento são divididos entre todas as partes envolvidas - Afeta a forma como a cobrança aparece no extrato bancário ou de cobrança do cliente (com as informações da sua plataforma ou do usuário) - Determina qual conta Stripe é debitada para reembolsos e estornos #### Item 1 Uma cobrança direta é um pagamento do cliente feito diretamente a uma conta conectada. Os clientes fazem transações diretamente com sua conta conectada e muitas vezes nem percebem a existência da sua plataforma Esse tipo de cobrança é mais adequado para plataformas que fornecem software como serviço. A Shopify, por exemplo, oferece ferramentas para a criação de lojas online, e a Worksify permite que professores vendam cursos online. #### Item 2 Crie cobranças de destino na sua plataforma e transfira fundos imediatamente para contas conectadas. Os clientes fazem transações com sua plataforma para comprar produtos ou serviços fornecidos por suas contas conectadas. Esse tipo de cobrança é mais adequado para marketplaces como o Airbnb, um marketplace de aluguel residencial, ou a Lyft, um aplicativo de transporte por aplicativo. As cobranças de destino são criadas na plataforma, mas durante as operações de cobrança, os fundos são imediatamente transferidos para a conta conectada especificada. Você pode decidir se alguns ou todos os fundos serão transferidos. A menos que você se qualifique para [repasses internacionais](https://docs.stripe.com/connect/cross-border-payouts.md), sua plataforma e a conta conectada para a qual você transfere fundos devem estar na mesma região para criar uma cobrança de destino. A tentativa de transferir fundos por uma fronteira não permitida retorna um erro. #### Item 3 Crie cobranças e transferências separadas para transferir fundos de um pagamento para várias contas conectadas ou quando um usuário específico não for conhecido no momento da cobrança. A cobrança na conta da sua plataforma é desvinculada das transferências para suas contas conectadas. Esse tipo de cobrança é mais adequado para marketplaces que precisam dividir pagamentos entre várias partes, como a DoorDash, uma plataforma de entregas para restaurantes. Embora cobranças e transferências separadas ofereçam muita flexibilidade, elas exigem uma integração mais complexa para gerenciar saldos de conta entre sua plataforma e seus usuários. Monitore cuidadosamente o saldo da conta da plataforma para garantir que você tenha fundos suficientes para cobrir o valor da transferência. A menos que você se qualifique para [repasses internacionais](https://docs.stripe.com/connect/cross-border-payouts.md), sua plataforma e a conta conectada para a qual você transfere fundos devem estar na mesma região para usar cobranças e transferências separadas. A tentativa de transferir fundos por uma fronteira não permitida retorna um erro. ### Tarifas da Stripe #### Item 1 A Stripe coleta tarifas da Stripe da conta da sua plataforma, incluindo tarifas de processamento. Você controla os valores das tarifas de processamento cobradas das contas conectadas. Use o parâmetro de tarifa da plataforma para coletar tarifas de processamento de suas contas conectadas. #### Item 1 (See full diagram at https://docs.stripe.com/connect/design-an-integration) #### Item 2 (See full diagram at https://docs.stripe.com/connect/design-an-integration) #### Item 3 (See full diagram at https://docs.stripe.com/connect/design-an-integration) #### Item 2 A Stripe cobra tarifas da Stripe diretamente das contas conectadas. Você pode coletar uma tarifa de aplicativo opcional ao criar a cobrança direta. (See full diagram at https://docs.stripe.com/connect/design-an-integration) ### Repasse fundos Quando os fundos do pagamento forem liquidados e a conta conectada do seu usuário tiver um saldo positivo na Stripe, você poderá repassar esses fundos para a conta externa do usuário. #### Item 1 Se você fizer onboarding de usuários em seu próprio fluxo usando a API da Stripe, também precisará coletar contas bancárias ou cartões de débito para configurar suas contas conectadas com uma conta de repasses. Depois de coletar os dados do usuário para a conta de repasses, vincule-os como uma conta externa. Os repasses serão bloqueados se sua conta conectada não tiver uma conta externa verificada. #### Item 2 #### Item 3 Por padrão, a Stripe repassa fundos que foram liquidados nos saldos de suas contas conectadas diariamente. Se preferir, você pode configurar diferentes cronogramas de repasses automáticos, acionar os repasses manualmente em vez de automaticamente ou fazer repasses instantâneos. ### Responsabilidade por saldos negativos #### Item 1 Sua plataforma é responsável por perdas incorridas por saldos negativos em suas contas conectadas. Sua plataforma é responsável por analisar novas contas conectadas durante o onboarding e determinar o perfil de risco dos usuários. Recomendado para marketplaces que recebem pagamentos de compradores para repassar a vendedores ou para plataformas avançadas que desejam controle total sobre como o risco e as obrigações com saldos negativos são gerenciados em contas conectadas: - Sua plataforma deve monitorar contas conectadas para verificar o risco contínuo de perdas. - Sua plataforma precisa criar fluxos para comunicar e remediar contas conectadas quando você detectar fraudes ou riscos. - Você tem a equipe operacional e os recursos de engenharia para estabelecer processos para gerenciar o risco contínuo de perda e prevenir fraudes. Antes de criar contas com essa configuração, considere e reconheça cuidadosamente as responsabilidades da sua plataforma por obrigações com saldos negativos. #### Item 2 A Stripe monitora sinais de risco em contas conectadas, implementa intervenções de risco em contas conectadas em resposta a sinais observados e busca recuperar saldos negativos de suas contas conectadas. Para a maioria das plataformas de software como serviço, essa é a melhor escolha padrão, especialmente para aquelas que são novas na incorporação de pagamentos: - A Stripe monitora o risco de crédito e de fraudes nas contas conectadas, além de proteção contra risco de perda em caso de saldos negativos atribuídos ao risco comercial. - A Stripe gerencia todas as comunicações e remediações de ponta a ponta diretamente com suas contas conectadas por meio de fluxos hospedados ou componentes integrados. #### Item 1 #### Componentes integrados obrigatórios Quando a Stripe é responsável por saldos negativos em contas conectadas, você precisa integrar componentes integrados para onboarding, gerenciamento de contas e banner de notificação. A Stripe usa o componente de banner de notificação integrado para notificar contas conectadas sobre requisitos pendentes ou outras solicitações relacionadas a riscos gerenciados. O componente de gerenciamento de contas é obrigatório para que suas contas conectadas possam gerenciar credenciais de autenticação e dados comerciais. A Stripe também envia e-mails para suas contas conectadas em seu nome para gerenciar riscos e confirmar a conformidade contínua. Você pode personalizar e marcar essas comunicações por e-mail com seu próprio domínio de e-mail e marca da plataforma. Para qualquer outro componente opcional, você também pode usar [componentes incorporados](https://docs.stripe.com/connect/get-started-connect-embedded-components.md) ou criar sua própria interface do usuário. #### Item 2 #### Item 3 ## Etapas de integração para suas seleções As etapas de integração a seguir são baseadas nas opções selecionadas acima. Você pode ver diferentes etapas selecionando diferentes opções acima ou no painel à direita das etapas. As opções nesta página controlam apenas as etapas exibidas abaixo. Elas não afetam a configuração da sua plataforma. O botão abaixo gera um prompt para LLM com base nas suas seleções. Este recurso é compatível apenas com o Dashboard da Stripe e integrações hospedadas.