Refund Order
Use this endpoint to refund orders with funds that have already been settled
Overview
The request body has an amount field. If this field is not passed with a value, the API will refund the full amount of the order. If you specify an amount in the request body, then that amount will be refunded.
This endpoint uses HMAC with SHA-256
Check out our API Authentication section to learn more
To refund an order, send an API call to:
Staging: POST https://stage-oms.skipify.com/{orderId}/refund
Production: POST https://oms.skipify.com/{orderId}/refund
Request Body Parameters
| Parameter Name | Required | Type | Description |
|---|---|---|---|
| amount | no | integer | If no value is provided for this field, the API will refund the entire amount from the previous transaction. If you specify an amount, it will be refunded only if it is less than or equal to the total amount of the captured funds. |
Request Body Example
{
"amount": 1523 // Represents $15.23
}
API Response
Response Body Parameters
| Parameter Name | Type | Description |
|---|---|---|
| orderId | string | The Skipify order id |
| merchantId | string | The Skipify Merchant identifier |
| amount | integer | The amount captured |
| transactionId | string | The Skipify transaction identifier |
| status | string | Allowed Values = Refunded, Failed |
| message | string, nullable | This message will be populated if there was an error processing the capture |
Response Body Example
{
"orderId": "string",
"merchantId": "string",
"amount": integer,
"transactionId": "string",
"status": "Refunded",
"message": "string"
}
Updated 8 days ago
What’s Next