Skip to main content
Use reconciliation when the payment state is uncertain after a timeout, worker crash, or delayed webhook.

​
Read APIs

  • GET /v2/transactions
  • GET /v2/transactions/{id}

​
Example request

curl --request GET \
  --url https://api.pagou.ai/v2/transactions/tr_1001 \
  --header "Authorization: Bearer YOUR_TOKEN"

​
Example response

{
  "success": true,
  "requestId": "req_1203",
  "data": {
    "id": "tr_1001",
    "external_ref": "order_1001",
    "status": "paid",
    "method": "pix",
    "amount": 1500,
    "currency": "BRL",
    "paid_at": "2026-03-16T14:03:10.000Z",
    "updated_at": "2026-03-16T14:03:10.000Z"
  }
}

​
Common error

Status 404 
{
  "type": "https://api.pagou.ai/problems/not-found",
  "title": "Resource Not Found",
  "status": 404,
  "detail": "The requested transaction does not exist."
}
Fix: verify the transaction ID and your own order-to-transaction mapping before retrying the lookup.

​
Reconciliation flow

  1. Load the Pagou transaction ID from your payment record or webhook store.
  2. Fetch the latest transaction state.
  3. Apply only forward-safe transitions in your system.
  4. Keep webhooks as the normal update path after recovery.

​
Next steps