Usar o Connect com contas conectadas Custom
Use contas conectadas Custom com o Connect para controlar toda a experiência das suas contas conectadas.
Observação
Os requisitos de verificação de identidade são atualizados para acompanhar a evolução das leis e regulamentos em todo o mundo. Se você está criando seu próprio fluxo de onboarding de contas, deve planejar a revisão e atualização dos requisitos de onboarding com frequência mínima de seis meses. Para evitar essa obrigação de manutenção, use o Connect Onboarding para contas Custom.
Uma conta conectada Custom é praticamente invisível para o titular da conta. Você (a plataforma) é responsável por todas as interações com suas contas conectadas e pela coleta de todos os dados necessários para verificar cada conta.
Com contas conectadas Custom, você pode modificar os dados e configurações da conta conectada usando a API, incluindo o gerenciamento das contas bancárias e do cronograma de repasses. Como os titulares de contas conectadas Custom não conseguem acessar a Stripe, você é responsável por criar o fluxo de onboarding, o painel da conta conectada, a funcionalidade de geração de relatórios e os canais de comunicação.
As seguintes etapas são criadas para criar uma conta conectada Custom:
- Verifique se você cumpre os requisitos mínimos.
- Identifique corretamente o país e quaisquer requisitos relacionados.
- Criar a conta.
- Conclua o processo de verificação de identidade.
Observação
Para cumprir os regulamentos PSD2 franceses, as plataformas na França devem usar tokens de conta. Um benefício adicional dos tokens é que a plataforma não precisa armazenar dados de identificação pessoal, que são transferidos da conta conectada diretamente para a Stripe. Para plataformas em outros países, recomendamos usar tokens de conta, mas não são obrigatórios.
Requisitos para criar contas conectadas Custom
Para criar contas conectadas Custom, você precisa cumprir todos estes requisitos:
- Versão mínima da API: é necessároi usar a versão de API 2014-12-17 ou mais recente. Você pode ver e atualizar a versão da API no Dashboard.
- Atualização dos termos de serviço: para criar contas conectadas Custom, você precisa atualizar seus termos de serviço para que incluam uma referência ao contrato de serviços da Stripe. A Stripe recomenda que você consulte seus advogados para determinar se deve atualizar o texto de aceitação dos seus termos para incluir uma referência aos termos da Stripe.
- Processamento de solicitações de dados: em vez de solicitar dados (como Social Security Number ou digitalização do passaporte) diretamente à sua conta conectada, a Stripe solicita os dados necessários para você. É sua responsabilidade coletar esses dados das suas contas conectadas e fornecê-los à Stripe. Caso contrário, a Stripe pode desativar os repasses para a conta conectada.
- Plataforma em um país aceito: plataformas na Alemanha, Austrália, Áustria, Bélgica, Brasil, Bulgária, Chipre, República Tcheca, Estônia, Finlândia, França, Grécia, Hong Kong, Hungria, Índia, Irlanda, Itália, Japão, Letônia, Lituânia, Luxemburgo, Malta, México, Países Baixos, Nova Zelândia, Noruega, Polônia, Portugal, Romênia, Singapura, Eslováquia, Eslovênia, Espanha, Suécia, Suíça, Tailândia, Reino Unido e Estados Unidos podem criar contas Custom para qualquer país aceito pela Stripe. Entre em contato conosco para receber notificação quando as plataformas em seu país puderem usar contas conectadas Custom.
- Países que não aceitam autoatendimento: devido a restrições que se aplicam ao uso do Connect nos Emirados Árabes Unidos, na Índia e na Tailândia, os usuários da plataforma nesses países não podem oferecer autoatendimento a contas conectadas Custom. Para começar o onboarding de contas conectadas Custom nesses países, fale conosco.
- Plataformas nos EAU: só é possível usar contas conectadas Custom nos EAU com os tipos de cobrança destination_charges e cobranças e transferências separadas. As cobranças de destino que usam o atributo on_behalf_of ainda não são aceitas em plataformas dos EAU.
Cuidado
Plataformas fora do México que desejam criar contas conectadas Custom no México e torná-las comerciantes de liquidação de fundos exigem uma análise mais aprofundada. Fale conosco para iniciar o processo.
- Verificação de fraudes: como sua plataforma é responsável por perdas incorridas pelas contas conectadas Custom, você deve analisar todas as contas que se registram por meio de sua plataforma para verificar se há fraudes. Consulte nosso guia de práticas recomendadas de gerenciamento de riscos para obter mais informações.
Há um custo adicional para contas conectadas Custom ativas. Uma conta conectada Custom é considerada ativa se recebe pelo menos um repasse bem-sucedido em um determinado mês.
Identificar o país a ser usado
A única informação de que você precisa para criar uma conta conectada Custom é o país onde a pessoa física ou empresa opera. Você pode coletar o restante em outro momento.
Por exemplo, se você está nos Estados Unidos e a empresa ou pessoa física para a qual você está criando uma conta conectada está representada legalmente no Canadá, atribua CA
como país.
O país também determina os dados de verificação necessários para a conta conectada.
Crie uma conta conectada Custom
O processo básico para criar e conectar uma conta conectada Custom é chamar o endpoint de criação da conta, definindo o type
como custom
e informando o país e as funções corretas.
Cuidado
As plataformas dos EUA podem criar contas para transferências internacionais especificando o contrato de serviços do destinatário.
O resultado de uma chamada da API bem-sucedida são os dados da conta conectada:
{ ... "id":
, "type": "custom" ... }"{{CONNECTED_ACCOUNT_ID}}"
Armazene id
no banco de dados (esse é o ID da conta). Para fazer autenticação como conta conectada, você passa esse valor no cabeçalho Stripe-Account
das solicitações.
Observação
Armazene o ID da conta recebido. Você precisa desses dados para executar solicitações em nome da conta conectada.
Iniciar o processo de verificação de identidade
Uma conta criada apenas com o país é bastante limitada: ela só pode receber pequenos valores. Se você quer habilitar repasses e manter a adimplência da conta, precisa informar mais dados do titular da conta. A página de dados de verificação necessários mostra os requisitos mínimos e prováveis de verificação de identidade.
A maneira mais fácil de coletar esses dados é integrar o Connect Onboarding, que transfere toda a complexidade da verificação para a Stripe. Do contrário, além de programar suas próprias chamadas de API para a integração inicial, será preciso acompanhar as mudanças nos requisitos de onboarding conforme as legislações do mundo inteiro forem mudando.
Você pode coletar os dados necessários quando cria a conta ou ao atualizar a conta mais tarde. No mínimo, recomendamos coletar e informar antecipadamente o nome e a data de nascimento do usuário da conta conectada. Se você coletar antecipadamente os dados de endereço, não deixe de validar o estado das contas nos Estados Unidos, Canadá e Austrália em seu fluxo de onboarding.
Observação
For accounts with business_type set to individual
, provide at least one individual
property (for example, individual.
) and a Person object is created automatically. If you don’t, or for accounts with the business_
set to company
, you need to create each Person for the account.
Webhooks
Após a criação da conta, todas as notificações sobre alterações na conta são enviadas aos webhooks como eventos account.
. Informe o URL do webhook do Connect nas configurações da conta, observe os eventos e responda a eles conforme a necessidade.
Veja também
Saiba mais sobre como trabalhar com contas conectadas Custom.