Atualizar dados verificados do usuário

Para contas conectadas nas quais sua plataforma coleta dados atualizados para requisitos vencidos ou alterados, você coleta os dados necessários de cada conta durante o onboarding e a Stripe os verifica. Se você atualizar dados verificados do usuário, a Stripe precisará revisá-los. Se a Stripe não conseguir verificar, você tem um período de carência de 14 dias para resolver os problemas e concluir a verificação.

Durante esse período de carência, as funções da conta permanecem inalteradas. Por exemplo, se as cobranças ou os repasses já estavam ativados, eles continuarão ativados até o final do período de carência. O valor de requirements.current_deadline determina o final do período de carência, que não será prorrogado se você atualizar mais dados. Cumpra todos os requisitos até o final do período de carência para evitar a desativação de cobranças ou repasses.

Os campos verificados a seguir podem ser atualizados, com um período de carência:

• Nome da empresa
• Tipo de empresa
• Nome
• Sobrenome
• Data de nascimento
• ID fiscal da empresa
• Registrador de ID fiscal
• Número de identificação pessoal

Estes campos não podem ser alterados após a verificação da empresa:

• Documentos de verificação

Alterar o representante da conta

Você precisa especificar um representante para ativar a conta, concordar com os termos da Stripe e atuar como contato principal da conta. O representante da conta pode ser alterado por qualquer motivo (por exemplo, o representante designado saiu da empresa ou não atua mais como proprietário ou executivo).

Para alterar o representante da conta:

• Se necessário, adicione um objeto Personpara o novo representante. Quando um objeto Person existente ou novo é designado como representante, a Stripe recomenda que ele seja verificado antes de prosseguir.
• Atualize o objeto Person para que ele deixe de ser o representante:

curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}}
/persons/
{{PERSON_ID}} \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d "relationship[representative]"=false

• Atualize o objeto Person para designar o novo representante:

curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}}
/persons/
{{PERSON_ID}} \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d "relationship[representative]"=true

• Monitore as matrizes requirements.currently_due e requirements.past_due para garantir que a conclusão da verificação do novo representante. Mesmo que o objeto Person do novo representante já tenha sido verificado, a função de representante pode criar requisitos adicionais.

Depois que você define um representante como false, a Stripe concede um período de carência de 14 dias para definir o novo representante como true e concluir a verificação.

Atualizar o número de identificação fiscal da conta

Quando sua conta conectada atualiza o ID fiscal verificado (pessoa física* ou jurídica), ela precisa aceitar novamente o Contrato de Serviços da Stripe (SSA) para aceitar a transferência da propriedade da conta e dos saldos da entidade atribuída ao ID fiscal inicial para a entidade atribuída ao novo ID fiscal. As informações abaixo descrevem o processo de cumprimento deste requisito quando o ID fiscal verificado de uma conta é alterado.

• Isso se aplica a alterações ou reenvios do número de ID e do ssn_last_4 atuais de um representante verificado.

Atualizar o ID fiscal com um período de carência

Depois de atualizar o ID fiscal, a conta passa por um período de carência de 14 dias, durante o qual será preciso aceitar novamente o Contrato de Serviços da Stripe (SSA) e verificar se cumpre todos os requisitos. Se a conta conectada não cumprir os requisitos após os 14 dias, suas cobranças e repasses serão suspensos

Há várias formas de coletar esse requisito:

• Se você usa o Connect Onboarding, pode fornecer um link para o fluxo de onboarding da Stripe. Desse ponto em diante, a conta poderá cumprir todos os requisitos necessários.

  • Para contas com acesso ao Stripe Dashboard Express, você pode criar um link de login do Dashboard de uso único que permite à conta editar o número de identificação fiscal e concordar novamente com o Contrato de Serviços da Stripe (SSA).
  • Para contas sem acesso ao Dashboard hospedado pela Stripe, você pode fornecer um link para o Connect Onboarding, onde sua conta pode editar o número de identificação fiscal e concordar novamente com o Contrato de Serviços da Stripe (SSA).

• Se você fizer o onboarding de contas conectadas por meio da sua plataforma em vez de usar o Connect Onboarding, será preciso cumprir esse requisito seguindo as instruções da seção a seguir.

Obter a concordância do Contrato de Serviços da Stripe mais uma vez

Se você permite que contas sem acesso ao Dashboard hospedado pela Stripe, inclusive contas Custom, atualizem o ID fiscal verificado por meio da sua plataforma, é preciso adicionar uma seção para deixar claro que a conta concorda mais uma vez com o Contrato de Serviços da Stripe (SSA). Você também deve deixar claro que o proprietário da conta associada ao TIN original concorda em transferir a propriedade da conta e seus saldos para o proprietário associado ao TIN atualizado.

Você pode fazer isso incluindo uma referência clara e um link para o contrato no idioma correto, abaixo. Em seguida, documente que a conta concorda com o uso da API de atualização de conta:

Use a API de atualização de conta para coletar os requisitos, informando o endereço IP do usuário e a data de aceitação como carimbo de data e hora. A data de aceitação da assinatura (tos_acceptance[date]) deve ser a hora em que sua conta conectada solicitou a atualização do número do ID fiscal ou qualquer horário posterior.

curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}} \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d "tos_acceptance[date]"=1609798905 \
  -d "tos_acceptance[ip]"="8.8.8.8"