v1

latestOpenAPI 3.1.0Copyright Pismo2026-07-247702,7523.1 MB

Claims

Confirm key claim

Confirm a DICT claim for a key.

On PSP timeout, a 202 Accepted response is returned and the process continues asynchronously and, when successful, emits an event.

This endpoint generates a <a href="https://developers.pismo.io/events/docs/pix-dict-claim-status-change-1" >Pix key claim status changed</a> event.

For more information, refer to Pix key transfer (key claim).

post/v2/pix/claims/confirm

Headers

Authorizationstring required

Example:Bearer eyJhbGci...IUzUx

Account token - an access token encoded with a Pismo account ID. Tokens can expire quickly, which can result in a <b>401 Unauthorized</b> message.

Idempotency-Keystring required

A unique ID to ensure the operation remains idempotent, allowing for operation repitition without causing unintended effects or duplication. An idempotent operation is one that can be applied multiple times, yet the outcome remains the same. it ensures that network errors, retries, or failures can occur without introducing inconsistencies.

Request body

claim_idstring required

Claim ID for key transfer. The Create key claim or Create DICT key claim endpoint returns this field.

reasonstring required

Reason that indicates why the card was added to the Protection Bulletin.

Example request

{
  "claim_id": "123e4567-e89b-12d3-a456-426655440000",
  "reason": "L"
}

Response

Claim confirmed

cancel_reason'USER_REQUESTED' | 'ACCOUNT_CLOSURE' | 'FRAUD' | 'DEFAULT_OPERATION' required

Confirm reason

claim_idstring required

Claim ID for key transfer. The Create key claim or Create DICT key claim endpoint returns this field.

completion_period_end_datetimestring date-time required

Completion period end for claim. Present for claim type OWNERSHIP. ISO 8601 format.

confirm_reason'USER_REQUESTED' | 'ACCOUNT_CLOSURE' | 'FRAUD' | 'DEFAULT_OPERATION' required

Confirm reason

keystring required

Pix key value.

key_type'CPF' | 'CNPJ' | 'PHONE' | 'EMAIL' | 'EVP' required

User information that can be used to create a Pix key:

CPF - Cadastro de Pessoas Fisicas (Indiviual Taxpayer Registry) number. Similar to a Social Security number in the US.
CNPJ - Cadastro Nacional de Pessoa Juridica (National Registry of Legal Entities) number. Unique ID for legal entities, such as companies and organizations, in Brazil
EMAIL - Email
PHONE - Phone number
EVP - Endereco de pagamento virtual (virtual payment address). A randomly-generated UUID number.

last_modified_datetimestring date-time required

Last modified datetime. A RFC 3339 date-time value. For example - 2023-04-12T23:20:50.52Z.

resolution_period_end_datetimestring date-time required

Resolution period end for claim. ISO 8601 format.

status'OPEN' | 'WAITING_RESOLUTION' | 'CONFIRMED' | 'CANCELLED' | 'COMPLETED' required

Claim status

type'OWNERSHIP' | 'PORTABILITY' required

Key claim type:

OWNERSHIP - Transfers key ownership between individuals in the same or another bank.
PORTABILITY- Transfers key ownership for the same individual to another bank.

correlation_idstring

The Correlation identifier field is used to link related API requests and events. The CID can help the Pismo engineering team track everything related to a call. If not passed, a random one is generated. You can find the CID in the response header.

donor_participantstring

Donor participant's ISPB (Identifcador do Sistema de Pagamento Brazil) number - the Brazilian Payment System identifier, an 8-digit value.

bacen_response_timestring date-time

Banco Central do Brasil (Central Bank of Brazil) response datetime. A RFC 3339 date-time value. For example - 2023-04-12T23:20:50.52Z.

Example response

{
  "cancel_reason": "USER_REQUESTED",
  "claim_id": "123e4567-e89b-12d3-a456-426655440000",
  "completion_period_end_datetime": "2020-01-24T10:00:00Z",
  "confirm_reason": "USER_REQUESTED",
  "key": "email@email.com",
  "key_type": "EMAIL",
  "last_modified_datetime": "2020-08-13T13:49:03Z",
  "resolution_period_end_datetime": "2020-01-17T10:00:00Z",
  "status": "OPEN",
  "type": "OWNERSHIP",
  "claimer": {
    "document_number": "7777888hh",
    "name": "Jerry Atrick",
    "type": "NATURAL_PERSON",
    "trade_name": "Acme Widgets"
  },
  "claimer_account": {
    "account_number": "98765432",
    "account_type": "TRAN",
    "opening_datetime": "2020-08-13T13:49:03Z",
    "branch": "011",
    "participant": "00115678"
  },
  "correlation_id": "c737895c-8159-4c0c-a92a-a4f8600bff37",
  "donor_participant": "99999011",
  "bacen_response_time": "2020-08-13T13:49:03Z"
}