Skip to main content
POST
Create Refund

Authentication

Include your Secret Key in the Authorization header as a Bearer token.

Request Body

transaction_id
string
required
The ID of the original successful transaction.
amount
string
Refund amount in smallest currency unit. If omitted, a full refund is issued.
reason
string
Code for the refund reason: requested_by_customer, duplicate, fraudulent, other.
notes
string
Additional context for the refund (up to 500 characters).

Response

id
string
Unique identifier for the transaction/refund wrapper.
refund_id
string
The specific ID of the refund (e.g., rf_...).
amount
string
The amount refunded.
currency
string
The currency code.
status
string
Status of the refund (succeeded, pending, failed).
reason
string
Reason for the refund.