Transações

Consultar transação

Retorna uma transação da sua conta — cobrança (PIX_IN) ou saque (PIX_OUT). Aceita o id gerado pela Reload Bank ou o seu external_id.
GET/api/v1/transactions/{id}

Parâmetros de caminho

CampoTipoObrigatórioDescrição
idstringSimid da transação ou o external_id informado na criação. A busca por id tem prioridade.

Resposta

Retorna 200 com o objeto Transação. O campo pix.qr_code_image não é retornado aqui — use pix.qr_code para regenerar o QR Code ou envie o cliente para o checkout_url.

Ao consultar uma cobrança PIX pendente cujo prazo já venceu, a transação é marcada como EXPIRED na hora (e o webhook transaction.expired é disparado).
Requisição
curl -X GET "https://reloadbank.app/api/v1/transactions/pedido-1042" \
  -H "Authorization: Bearer $ACCESS_TOKEN"
Resposta
{
  "id": "cm2r8x1qz0004lk08abcd1234",
  "external_id": "pedido-1042",
  "type": "PIX_IN",
  "status": "PAID",
  "amount": 100,
  "fee": 1.75,
  "net_amount": 98.25,
  "description": "Pedido #1042",
  "pix": {
    "txid": "K7Q2M9X4T1B8N6R3W5Z0C2V7H",
    "end_to_end_id": "E00000000202610161432K8D2LQ7ZP1M",
    "qr_code": "00020101021226580014br.gov.bcb.pix013600000000-0000-0000-0000-0000000000005204000053039865406100.005802BR5912LOJA EXEMPLO6009SAO PAULO62290525K7Q2M9X4T1B8N6R3W5Z0C2V7H63040000",
    "expires_at": "2026-10-16T15:30:00.000Z"
  },
  "checkout_url": "https://reloadbank.app/pay/cm2r8x1qz0004lk08abcd1234",
  "payer": {
    "name": "Maria Silva",
    "document": "12345678909",
    "email": "[email protected]"
  },
  "failure_reason": null,
  "metadata": {
    "order_id": 1042,
    "channel": "site"
  },
  "paid_at": "2026-10-16T14:32:11.000Z",
  "refunded_at": null,
  "created_at": "2026-10-16T14:30:00.000Z",
  "updated_at": "2026-10-16T14:32:11.000Z"
}