Refund
Create a refund
Creates a new refund object.
This fails with:<a name="total_amount_confirmation_invalid"></a><a name="number_of_refunds_exceeded"></a><a name="available_refund_amount_insufficient"></a>
-
total_amount_confirmation_invalid if the confirmation amount doesn't match the total amount refunded for the payment. This safeguard is there to prevent two processes from creating refunds without awareness of each other.
-
available_refund_amount_insufficient if the creditor does not have sufficient balance for refunds available to cover the cost of the requested refund.
post/refunds
Request
- Base URLhttps://api.gocardless.com
- AuthHTTP bearer
Headers
GoCardless-Versionstring required
Request body
Example request
{
"refunds": {
"reference": "WINEBOX001",
"links": {
"payment": "PM123",
"mandate": "MD123"
}
}
}Response
Resource created successfully
Example response
{
"refunds": {
"id": "RF123",
"created_at": "2014-01-01T12:00:00.000Z",
"amount": 150,
"currency": "EUR",
"status": "submitted",
"reference": "WINEBOX001",
"links": {
"payment": "PM123",
"mandate": "MD123"
},
"fx": {
"exchange_rate": "1.1234567890",
"estimated_exchange_rate": "1.1234567890",
"fx_currency": "EUR"
}
}
}Changes
No recorded changes to this operation across all 1 revision of this API.