Simulação de reconhecimento de pedido de reivindicação

simulação

No fluxo de reivindicação de posse ou portabilidade de chave Pix, o Bankly ou a instituição financeira detentora da chave receberá o pedido de reivindicação e deverá fazer o seu reconhecimento (acknowledgement).

Como em produção o processo de reconhecimento ou recusa de pedido é automático por parte do Bankly, disponibilizamos em sandbox o endpoint de simulação de reconhecimento de pedido de reivindicação.

Desse modo, nosso parceiro poderá simular o fluxo completo de reivindicação de posse ou portabilidade de chaves.

Pré-requisito

Para que seja possível utilizar este endpoint, é necessário que:

  • Um pedido de reivindicação de posse ou portabilidade de chaves tenha sido criado.

Requisição

Requisição HTTP

POST https://api.sandbox.bankly.com.br/pix/stub/claim/acknowledge
curl --location 
--request POST 'https://api.sandbox.bankly.com.br/pix/stub/claim/acknowledge' \
--header 'accept: application/json' \
--header 'api-version: 1' \
--header 'Content-Type: application/json' \
--header 'x-bkly-pix-user-id: 47742663023' \
--header 'Authorization: Bearer Token' \
--data-raw '{
    "claimId": "47ce6878-c73f-4fad-a94b-3474d2e5b6e2",
    "claimType": "PORTABILITY",
    "addressingKey": {
        "type": "PHONE",
        "value": "+5523415162342"
    },
    "claimer": {
        "branch": "0001",
        "number": "15164",
        "bankISPB": "13140088",
        "holder": {
            "documentNumber": "47742663023"
        }
    },
    "donor": {
        "branch": "0001",
        "number": "540108",
        "bankISPB": "13140088",
        "holder": {
            "documentNumber": "47742663023"
        }
    },
    "status": "OPEN",
    "createdAt": "2023-01-11T14:38:47.2359473Z",
    "resolutionLimitDate": "2023-01-18T14:38:47.2359473Z", 
    "conclusionLimitDate": "2023-01-25T14:38:47.2359473Z" 
}'

Autorização

Por se tratar de um endpoint de simulação, a requisição não exige o uso de scope.

Cabeçalhos (Headers)

NomeDescriçãoEspecificação
api-versionObrigatório. Versão da API. Atualmente estamos na versão 1.0.---
AuthorizationObrigatório. Token de autorização do tipo Bearer e formato JWT.---
x-bkly-pix-user-idObrigatório. Informe o número do documento do cliente que está fazendo a requisição.Insira apenas números, sem formatação.

Parâmetros da rota (Path)

Não é necessário enviar parâmetros no path desta requisição.

Corpo da requisição (Body)

No body, envie os seguintes campos em formato JSON:

NomeTipoDescriçãoEspecificação
claimIdstringObrigatório. Identificador único do pedido. Este valor é retornado na criação de pedido de reivindicação de chave.---
claimTypestringObrigatório. Tipo do pedido, que pode ser portabilidade (PORTABILITY) ou reivindicação (OWNERSHIP).---
addressingKeyobjectObrigatório. Objeto que contém as informações sobre a chave reivindicada.--
addressingKey.typestringObrigatório. Tipo de chave de endereçamento do DICT. Exemplo: CPF, CNPJ, EMAIL, PHONE ou EVP.---
addressingKey.valuestringObrigatório. Valor da chave.---
claimerobjectObrigatório. Objeto que contém os dados do reivindicador da chave.---
claimer.branchstringObrigatório. Número da agência bancária.---
claimer.numberstringObrigatório. Número da conta.---
claimer.bankISPBstringObrigatório. ISPB da instituição financeira.---
claimer.holderobjectObrigatório. Objeto que contém informações sobre o titular da conta.---
claimer.holder.documentNumberstringObrigatório. Número do documento do titular da conta.Insira somente números, sem formatação.
donorobjectObrigatório. Objeto que contém os dados do doador da chave.---
donor.branchstringObrigatório. Número da agência bancária.---
donor.numberstringObrigatório. Número da conta.---
donor.bankISPBstringObrigatório. ISPB da instituição financeira.---
donor.holderobjectObrigatório. Objeto que contém informações sobre o titular da conta.---
donor.holder.documentNumberstringObrigatório. Número do documento do titular da conta.Insira somente números, sem formatação.
statusstringObrigatório. Situação do pedido.---
createdAtstringObrigatório. Data em que o pedido foi realizado.Formato YYYY-MM-DDTHH:mm:SS.
resolutionLimitDatestringObrigatório. Data limite para o doador de portabilidade realizar ações, como concluir ou cancelar o pedido de reivindicação.Formato YYYY-MM-DDTHH:mm:SS.
conclusionLimitDatestringObrigatório. Data limite para o doador de posse e o reivindicador (tanto de posse como de portabilidade) confirmarem ou cancelarem o pedido.Formato YYYY-MM-DDTHH:mm:SS.

🚧

Importante

Para garantir que a simulação funcione, no campo status, o parceiro deve informar o valor “OPEN”, e nos campos createdAt, resolutionLimitDate e conclusionLimitDate deve inserir as datas retornadas na requisição de criação pedido de reivindicação de chave Pix.

{
    "claimId": "47ce6878-c73f-4fad-a94b-3474d2e5b6e2",
    "claimType": "PORTABILITY",
    "addressingKey": {
        "type": "PHONE",
        "value": "+5523415162342"
    },
    "claimer": {
        "branch": "0001",
        "number": "15164",
        "bankISPB": "13140088",
        "holder": {
            "documentNumber": "47742663023"
        }
    },
    "donor": {
        "branch": "0001",
        "number": "540108",
        "bankISPB": "13140088",
        "holder": {
            "documentNumber": "47742663023"
        }
    },
		"status": "OPEN",
    "createdAt": "2023-01-11T14:38:47.2359473Z",
    "resolutionLimitDate": "2023-01-18T14:38:47.2359473Z", 
    "conclusionLimitDate": "2023-01-25T14:38:47.2359473Z" 
}

Resposta (Response)

O status code 201 indicará que a simulação foi realizada com sucesso.

Erros

Este endpoint não retorna erros. Caso ocorra algum problema na requisição, o evento a seguir não será disparado e o status da portabilidade não será alterado para WAITING_RESOLUTION.

Eventos

Após simular a requisição, caso obtenha sucesso, o parceiro receberá o evento PIX_CLAIM_WAS_ACKNOWLEDGED, que indica que o pedido de reivindicação foi reconhecido.

Trata-se do mesmo evento que é disparado no fluxo real, após o reconhecimento do pedido de reivindicação por parte da outra instituição financeira, mas com dados fictícios.

📘

Nota

Lembre-se de que é preciso configurar o webhook para receber o evento.