Pix ProcessamentoPix Processamento Docs
Endpoints da APICallbacks

Listar callbacks

PortuguêsEnglish中文
GET
/user/callbacks

Autorização

BearerAuth
AutorizaçãoBearer <token>

Em: header

Parâmetros de query

page?integer
Padrão1
Intervalo1 <= value
limit?integer
Padrão10
Intervalo1 <= value <= 100
sortBy?string
Padrão"createdAt"
Valor em"createdAt" | "status"
sortDirection?string
Padrão"desc"
Valor em"asc" | "desc"
id?string

Filtra por ID de callback

url?string

Filtra por callback URL

status?integer

Código de status HTTP

transactionId?string
hasError?boolean

Filtra callbacks que apresentaram erro

createdAtFrom?string
Formatodate-time
createdAtTo?string
Formatodate-time

Corpo da resposta

application/json

application/json

application/json

application/json

curl -X GET "https://api.exemplo.processamento.com/v1/user/callbacks"
{
  "pagination": {
    "page": 1,
    "limit": 10,
    "hasNextPage": true
  },
  "callbacks": [
    {
      "id": "cmh211yjm03ohs601kf7672du",
      "url": "https://great-lock-79.webhook.cool",
      "status": 200,
      "transactionId": "PIX2025102213082667EDC8079C",
      "createdAt": "2025-10-22T13:26:53.219Z",
      "responseTime": 124,
      "body": {
        "id": "PIX2025102213082667EDC8079C",
        "type": "DEPOSIT",
        "status": "REFUNDED"
      },
      "responseBody": "OK",
      "responseHeaders": {
        "content-type": "text/plain; charset=UTF-8"
      }
    }
  ]
}
{
  "statusCode": 400,
  "error": "Bad Request",
  "message": "querystring/dateFrom Invalid input: expected string, received undefined",
  "requestId": "cmou00000abcdef01s6ghij1k2lm"
}
{
  "statusCode": 401,
  "error": "Unauthorized",
  "message": "Missing or invalid Bearer token",
  "requestId": "cmou00000abcdef01s6ghij1k2lm"
}
{
  "statusCode": 404,
  "error": "Not Found",
  "message": "Resource not found",
  "requestId": "cmou00000abcdef01s6ghij1k2lm"
}

Callbacks

Inspecionar histórico de callbacks enviados, reenviar manualmente uma entrega individual ou em lote. Útil para auditoria, debug e reprocessamento de falhas.

Detalhe do callback GET

Retorna os detalhes completos de um callback específico, incluindo body enviado, resposta recebida e tempo de round-trip.