Skip to main content
Card refunds use the same PUT /v2/transactions/{id}/refund public operation as Pix.

​
Practical guidance

  • Submit refunds from your backend only.
  • Use an internal refund request record to avoid duplicate reversals.
  • Expect refunded or partially_refunded as the business-facing states you care about.
  • Reconcile before retrying a refund after timeouts or uncertain HTTP outcomes.

​
Merchant-facing rules

  • Do not mark a refund as settled until you have webhook or reconciliation confirmation.
  • Keep original payment ID and refund operation metadata linked in your system.