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:

• Business name
• Business type
• First name
• Last name
• Date of birth
• Business tax ID
• Tax ID registrar
• Personal ID number

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

• Verification documents

Change the account representative

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:

• If necessary, add a Person object for the new representative. Stripe recommends that you verify the Person before proceeding, whether you designate an existing Person as the new representative or add a new Person.
• Atualize o objeto Pessoa para que ele deixe de ser o representante:

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

curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}}
/persons/
{{PERSON_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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

After the account updates its Tax ID, the account enters a 14-day grace period during which it must re-accept the Stripe Services Agreement (SSA) and make sure it’s compliant with all requirements. If the connected account can’t meet its requirements after 14 days, Stripe pauses charges and payouts for the account. To collect this requirement, you can:

• Se você usa o Connect Onboarding, forneça um link para o fluxo de onboarding da Stripe. A partir daí, a conta poderá cumprir todos os requisitos necessários.
  • Para contas com acesso ao Stripe Dashboard Express, você pode criar um link de login de uso único para o Dashboard que permite à conta editar o número de identificação fiscal e concordar novamente com o Contrato de Serviços da Stripe (SSA).
  • For accounts with no Stripe-hosted Dashboard access, provide a link to Connect Onboarding, where your account can edit their tax identification number and re-accept the Stripe Services Agreement (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:

• Atualize o objeto Pessoa para designar o novo representante:

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_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "tos_acceptance[date]"=1609798905 \
  -d "tos_acceptance[ip]"="8.8.8.8"