Refund a payment
Issue a full or partial refund for a previously settled payment. By default, the full amount will be refunded unless a specific amount is provided for a partial refund.
If the payment was partially captured multiple times, you can specify which capture to
refund by using the transaction event ID. Refer to the transactions.events
array in the
payment object to find available transaction event IDs (when the appropriate expand
parameter is passed).
When specifying a transaction event ID, the refund amount should not exceed the amount captured in that event. If no refund amount is provided, it defaults to the amount captured in that specific event.
Path parameters
Headers
Specifies the version of the API to use. This must be set to 2.4
.
Request
The amount you would like to refund the customer, in minor units. e.g. for $7, use 700
.
Defaults to remaining non-refunded amount.
Optionally you can pass a specific order ID for the refund.
By default this will be set to the original orderId
given on payment creation.
Response
Check this field for more information regarding the payment’s status. This is especially useful when the status is DECLINED
or FAILED
.
A list summarizing the transactions that occurred while processing the payment.
Note: a refund is a separate transaction and so will appear in this transactions
list if a refund was performed.