Skip to main content
Reconciliation is the safety net for your payment flow, not the primary event transport.

Read operations

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

When to reconcile

  • Your webhook consumer timed out or failed after acknowledgement.
  • A customer support case needs a verified current state.
  • Your initial write response was lost.
  • A long-lived pending or processing state needs follow-up.

Example by ID

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

Best practice

  1. Identify the Pagou transaction ID from your internal record.
  2. Fetch the current state.
  3. Compare it with your local state.
  4. Apply only forward-safe transitions in your domain model.