Quando os Dados do Cliente Podem Ser Atualizados

Se um campo ou documento pode ser alterado depende de duas coisas: o status de cada um dos perfis de verificação do cliente, e quais perfis já avaliaram aquele campo. Esta página apresenta a regra e depois a aplica aos clientes pessoa física.

A regra

Um campo ou documento está bloqueado quando é um critério complete de um perfil de verificação cujo status é pending ou approved. Todo o resto pode ser alterado com PATCH /v2/customer/{id} ou POST /v2/document.

Status do perfil	Efeito sobre os critérios que ele avaliou
`incomplete`	Nada bloqueado. Forneça ou corrija qualquer campo ou documento.
`pending`	Todos os critérios `complete` bloqueados enquanto a análise está em andamento.
`approved`	Todos os critérios `complete` bloqueados.
`rejected`, `resubmission_required`	Nada bloqueado. Corrija o que `criteria.errors` lista e o perfil é reenviado por conta própria.

Critérios compartilhados por vários perfis ficam bloqueados se qualquer um desses perfis estiver em pending ou approved. Critérios que nenhum perfil bloqueante do cliente avaliou continuam editáveis, e é isso que permite adicionar um perfil a um cliente em pending ou approved. Documentos que você já enviou para um perfil anterior são reavaliados para um perfil recém-adicionado e aparecem no criteria.pending dele até que essa verificação termine; os campos de dados são transferidos como complete imediatamente. Um PATCH rejeitado retorna 400 customer/field-locked-by-verification-profile e não aplica nada. O corpo nomeia cada campo bloqueado e o perfil que o bloqueia:

{
  "status": 400,
  "code": "customer/field-locked-by-verification-profile",
  "detail": "One or more fields are locked by a verification profile that is pending or approved.",
  "errors": [
    {
      "detail": "personalInformation.actingAsIntermediary is locked by verification profile kyc_profile_a (pending).",
      "pointer": "/personalInformation/actingAsIntermediary"
    }
  ]
}

Uploads de documentos retornam o mesmo código; a entrada de erro carrega parameter: "documentType" e nomeia o perfil bloqueante em detail. Remover um perfil de enabledVerificationProfiles enquanto ele está em pending ou approved retorna o mesmo código com pointer: "/enabledVerificationProfiles".

Sempre imutáveis

firstName, lastName, dateOfBirth, email e phone não podem ser alterados após a criação em nenhum status. Crie um novo cliente se esses dados estiverem errados.

Clientes pessoa física

Os bloqueios seguem as entradas kyc_profile_* do cliente. A tabela mostra quais perfis avaliam cada critério; um critério fica bloqueado enquanto qualquer perfil marcado estiver em pending ou approved.

Critério	Campo ou documento	A	C	D
`residential_address`	`address`	✓	✓	✓
`tax_identification_number`	`personalInformation.taxIdentificationNumber*`	✓	✓	✓
`identity_document`, `liveness_report_document`, `source_of_funds_document`	uploads de documentos	✓	✓	✓
`source_of_funds`, `occupation_soc_code`	`personalInformation.sourceOfFunds`, `occupationSocCode`	✓	✓	✓
`account_purpose`, `employment_status`, `acting_as_intermediary`	`personalInformation.accountPurpose`, `employmentStatus`, `actingAsIntermediary`	✓	—	—
`expected_monthly_payments`	`personalInformation.expectedMonthlyPayments`	✓	—	✓
`country_of_birth`, `nationality`	`personalInformation.countryOfBirth`, `nationality`	Residentes EEA+	✓	✓
`sex`	`personalInformation.gender`	—	✓	✓
`proof_of_address_document`, `w8_ben_document`	uploads de documentos	—	✓	✓
`state_of_birth`	`personalInformation.stateOfBirth`	—	—	✓
critérios de atividade esperada	`personalExpectedActivity`	—	—	✓
`ip_address`	`ipAddress`	—	—	✓

Exemplo — perfil A em pending ou approved, adicionando o perfil C. Tudo na coluna A está bloqueado. gender, countryOfBirth e nationality (para um cliente fora da EEA+), mais os uploads de comprovante de endereço e W-8BEN, estão abertos porque apenas C os avalia. Depois de fornecidos, kyc_profile_c passa para pending e também os bloqueia. Exemplo — perfil A rejeitado. Nada está bloqueado. Corrija os campos listados em criteria.errors, reenvie documentos se solicitado, e o perfil é reenviado automaticamente.

Clientes pessoa jurídica

PATCH /v2/customer/{id} ainda não está disponível para clientes pessoa jurídica, incluindo alterações em enabledVerificationProfiles; ele retorna 400 customer/operation-not-allowed. Os uploads de documentos da empresa e de seus representantes não são afetados. Entre em contato com support@spherepay.co se uma empresa existente precisar de um novo perfil.

Onboarding

Transferências

Automação

Webhooks

Dados de referência

Operacional

Quando os Dados do Cliente Podem Ser Atualizados

A regra

Sempre imutáveis

Clientes pessoa física

Clientes pessoa jurídica

Guias relacionados

Visão geral dos perfis de verificação

Cadastrar um cliente com perfis

​A regra

​Sempre imutáveis

​Clientes pessoa física

​Clientes pessoa jurídica

​Guias relacionados

Visão geral dos perfis de verificação

Cadastrar um cliente com perfis

A regra

Sempre imutáveis

Clientes pessoa física

Clientes pessoa jurídica

Guias relacionados