Validate Charge by txid

Validates a charge by its transaction identifier (txid) and returns charge information in cob-shaped fields, with this API's own status vocabulary (ACTIVE/COMPLETED/...), not the Bacen one. 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. Must be 26-35 lowercase alphanumeric characters [a-z0-9]

Responses

application/json

Código interno	HTTP	Descrição	Erro normativo Bacen
`PIX-0001`	400	Headers x-branch and x-account-number are required	`PixConsultaInvalida`

application/json

application/json
application/json

Código interno	HTTP	Descrição	Erro normativo Bacen
`CHARGE-0018`	404	Charge not found	`CobNaoEncontrado`

Código interno	HTTP	Descrição	Erro normativo Bacen
`CHARGE-0022`	409	Charge has already been settled	`CobOperacaoInvalida`

application/json

application/json

Código interno	HTTP	Descrição	Erro normativo Bacen
`CHARGE-0023`	410	Charge is no longer available (expired, cancelled, or deleted)	`PermanentementeRemovido`

get/api/cob/{txid}/validate

curl http://localhost:8080/api/cob/txid12345678901234567890123456/validate \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

Show Schema

{
  "txid": "string",
  "status": "ACTIVE",
  "revision": 1,
  "calendar": {
    "createdAt": "2026-09-16T19:14:18.661Z",
    "expiration": 1,
    "dueDate": "2026-09-16",
    "validAfterDueDays": 1
  },
  "amount": {
    "original": "string",
    "changeMode": 1,
    "cashWithdrawal": {
      "withdrawal": {
        "cashAmount": "string",
        "changeMode": 1,
        "agentModality": "AGTEC",
        "cashierIspb": "string"
      },
      "change": {
        "cashAmount": "string",
        "changeMode": 1,
        "agentModality": "AGTEC",
        "cashierIspb": "string"
      }
    }
  },
  "key": "string",
  "location": {
    "id": "string",
    "url": "string"
  },
  "payerRequest": "string",
  "additionalInfo": [
    {
      "name": "string",
      "value": "string"
    }
  ]
}

Charge validated successfully