Como funciona o processo de reivindicação?
A reivindicação de uma chave PIX, permite a solicitação da posse de uma chave que já está cadastrada em outra conta. Para que ela seja confirmada é necessário que a conta solicitante valide que tem acesso ao e-mail ou celular através de um OTP e a conta cedente precisa autorizar a liberação da chave após a solicitação.
Existe também a possibilidade do repasse da chave ocorrer, caso a conta que detém a posse da mesma não responda a solicitação de reivindicação dentro do prazo esperado que é de até 7 dias.
Como realizar a reivindicação na API?
Para que seja realizada a reivindicação intra PSP (duas contas cadastradas na Flagship), existem algumas etapas a serem feitas e para isso chamaremos a conta 1, a conta que tem a chave atualmente cadastrada e de conta 2, a conta para qual a chave será enviada:
1 - Conta_2 faz o cadastro da chave api: /v1/accounts/{{accountId}}/aliases
Após a realização o status da chave será: IDENTITY_VALIDATION_PENDING
2 - Conta_2 faz a Confirmação de posse api: /v1/accounts/{{accountId}}/aliases/{{alias}}/otp-validation
Após a realização o status da chave será: PENDING_CLAIM_CONFIRMATION
3 - Conta_2 faz Revindicação de posse api: /v1/accounts/{{accountId}}/aliases/{{alias}}/ownership-claims
Após a realização o status da chave será: CLAIM_AWAITTING_RETURN_PSP_DONOR
4 - Conta_1 faz a doação através da Confirmação reivindicação posse de alias api: /v1/accounts/{{accountId}}/aliases/{{alias}}/ownership-claim-responses
OBS: Nessa etapa é importante informar o parâmetro "confirm" como "false" (para doar a chave).
Após a realização a CONTA 1 não encontrará a chave e CONTA 2 terá a chave com o status PENDING_VALIDATION_COMPLETE_CLAIM
5 - Conta_2 Realiza novamente a inclusão da chave: api: /v1/accounts/{{accountId}}/aliases
6 - Conta_2 Confirma a pose através da "Confirmação de posse de alias" api: /v1/accounts/{{accountId}}/aliases/{{alias}}/otp-validation
Após a realização o status da chave será: ACTIVE
Caso tenha alguma dúvida, basta abrir um chamado no nosso portal