Usar o Connect com contas Custom
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 Stripe Custom é praticamente invisível para o titular da conta. Você (a plataforma) é responsável por todas as interações com os usuários e pela coleta de todos os dados necessários para verificar a conta.
Com contas 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 Custom não acessam a Stripe, cabe a você criar o fluxo de onboarding, o Dashboard dos usuários, as funções de geração de relatórios e os canais de comunicação.
Basta uma única chamada de API para criar uma conta Custom, mas você precisa considerar três etapas para cada conta criada:
- Identificar adequadamente o país a ser usado.
- Criar a conta.
- Acionar o processo de verificação de identidade.
Antes disso, verifique se você cumpre os requisitos mínimos.
Observação
As plataformas francesas precisam usar tokens de acesso, uma alternativa ao modelo de agente para conformidade da plataforma com a PSD2. A principal vantagem dos tokens para plataformas francesas é que os dados são transferidos do usuário diretamente para a Stripe. Não precisar armazenar dados de identificação pessoal é um benefício, mas não necessariamente um requisito. Para plataformas em outros países, os tokens de conta são opcionais, mas recomendados.
Requisitos para criar contas Custom
Para criar contas Custom, você precisa cumprir todos estes requisitos:
- Versão mínima da API: você precisa 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 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 aos usuários, a Stripe solicita os dados necessários para você. É sua responsabilidade coletar esses dados dos usuários 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 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 Connect Custom. Para começar o onboarding de contas Connect Custom nesses países, fale conosco.
- Plataformas nos EAU: só é possível usar contas 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 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 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 Custom ativas. Uma conta Custom é considerada ativa se recebe pelo menos um repasse bem-sucedido em um determinado mês.
Identificar o país a ser usado
O único dado necessário para criar uma conta Custom é o país principal de operação da pessoa física ou jurídica. Todo o resto pode ser coletado e atualizado depois.
Por exemplo, se você está nos Estados Unidos e a empresa ou indivíduo para quem você está criando uma conta está representado legalmente no Canadá, use CA
como país da conta sendo criada.
O país também determina os dados de verificação necessários para a conta conectada.
Criar uma conta Custom
O mínimo necessário para criar uma conta Custom é definir type
como custom
na solicitação de criação de conta e informar um país e as funções adequadas.
Cuidado
As plataformas dos EUA podem criar contas para transferências internacionais especificando o contrato de serviços do destinatário.
Os dados da conta do usuário são o resultado de uma chamada de API bem-sucedida:
{ ... "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. Esse dado será necessário para executar solicitações em nome do usuário.
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. 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
Para contas com business_type definido como individual
, forneça pelo menos uma propriedade individual
(por exemplo, individual.first_name
) e um objeto Person será criado automaticamente. Se você não o fizer, ou para contas com o business_type
definido como company
, erá preciso criar cada Person para a conta.
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.updated
. 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 Custom.