Cancelamento de um pedido de reivindicação

O endpoint de cancelamento de um pedido de reivindicação pode ser utilizado pelo doador da chave quando ele desejar cancelar um pedido de portabilidade.

Porém, só será possível realizar o cancelamento de reivindicações com o status WAITING_RESOLUTION.

🚧

Importante

O cliente doador só poderá cancelar um pedido de reivindicação de portabilidade de e-mail e telefone após validar a posse da chave através do código TOTP.

Endpoint

Para utilizar o endpoint de cancelamento de um pedido de reivindicação de chaves, preencha obrigatoriamente os seguintes campos:

Path

• claimId: identificador único do pedido. Este valor é retornado na criação de pedido de reivindicação de chave;

Header

• x-bkly-pix-user-id: número do documento do cliente que está fazendo a requisição. Insira apenas números, sem formatação;

• x-bkly-transactional-hash: o envio desse campo no header da requisição é obrigatório apenas para cancelamento de reivindicação de portabilidade de chaves do tipo e-mail e telefone, realizado pelo doador. Ele deve ser preenchido com o hash gerado na criação do código TOTP.

Body

• reason: motivo do cancelamento do pedido. Esse campo deve ser preenchido com "DONOR_REQUEST" (pedido do doador).

curl --location --request PATCH 'https://api-mtls.sandbox.bankly.com.br/pix/claims/{{CLAIMID}}/cancel' \ 
--header 'api-version: 1' \ 
--header 'x-bkly-pix-user-id: {{DOCUMENT_NUMBER}}' \ 
--header 'Content-Type: application/json' \ 
--header ' x-bkly-transactional-hash: {{hash}}' \ 
--header 'Accept: application/json' \ 
--header 'Authorization: {{Bearer}} ' \ 
--data-raw '{ 
  "reason": "DONOR_REQUEST" 
}'

Retorno

O sucesso na requisição retornará o status code 200.

Erros