Skip to main content
Use this page when your product supports post-payment reversal.

​
Refund operation

PUT /v2/transactions/{id}/refund

​
Example

curl --request PUT \
  --url https://api.pagou.ai/v2/transactions/trx_123/refund \
  --header "Authorization: Bearer YOUR_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "amount": 500
  }'

​
Operational model

  • Use your internal refund request ID to prevent duplicate operations.
  • Persist the refund request, the transaction ID, and the resulting status.
  • Update merchant-facing finance state only after webhook confirmation or successful reconciliation.

​
Common states after refund

  • refunded
  • partially_refunded

​
Failure handling

  • If the HTTP outcome is unclear, fetch the transaction again before submitting another refund.
  • If the API rejects the refund, surface the rejection reason to operations rather than retrying blindly.