Skip to main content
Deprecated in V4: Refunds have been consolidated into the unified Transaction model. Use GET /v4/transactions?type=refund to retrieve refunds.
In V4, Refunds are now represented as Transactions with type: "refund". This provides a unified way to manage all monetary movements including payments, refunds, and credits.

Migration Guide

Previous V3 Approach

GET /v3/payments/refunds

New V4 Approach

GET /v4/payments/transactions?type=refund

Key Changes

V3 FieldV4 Transaction Field
refund_idplatform_id
amountamount
payment_idoriginal_transaction_id
statusstatus
-type (set to “refund”)
-reason
-reason_code
See the Transaction overview for the complete V4 schema.