Validate Charge by txid

​

Validates a charge by its transaction identifier (txid) and returns charge information in a Pix-compatible format (cob). Checks that the charge exists, is active, and has not expired. Returns 404 if not found, 409 if already settled, 410 if expired/cancelled.

Path Parameters
  • txid
    Type: string
    required

    Transaction identifier (txid) of the charge to validate

Headers
  • x-branch
    Type: string
    required

    Branch of the charge owner account

  • x-account-number
    Type: string
    required

    Number of the charge owner account

  • Idempotency-Key
    Type: string
    required

    Unique idempotency key

Responses
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for get/cob/{txid}/validate
curl http://localhost/cob/txid12345678901234567890123456/validate \
  --header 'x-branch: ' \
  --header 'x-account-number: ' \
  --header 'Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "txid": "string",
  "status": "ATIVA",
  "revision": 1,
  "calendar": {
    "criacao": "2026-07-31T12:59:10.330Z",
    "expiracao": 1
  },
  "amount": {
    "original": "string",
    "modalidadeAlteracao": 1
  },
  "key": "string",
  "location": {
    "id": "string",
    "url": "string"
  },
  "payerRequest": "string",
  "additionalInfo": [
    {
      "nome": "string",
      "valor": "string"
    }
  ]
}

Charge validated successfully