Using the value of the redemptions array provided when redeeming a voucher or part of a voucher you can reverse this redemption in the event of a void or refund of that voucher redemption or transaction.
POST REQUEST (/redeem/reverse)
Header: Content-Type application/json
Header: Accept application/json
Header: Smart-Auth sk_XXXXXXXXXXXXXXXXXX
You can find the site number you should submit along with this request in the company configuration on the Smart Gift dashboard.
For the value you should either submit the monetary value OR the sum of the bit_value of the experiences that you wish to redeem.
For the redemptions you should provide an array of redemption ID's as provided in the redemption step.
{
"voucher_no":"XXXXXXXXXX",
"site_id": "X",
"value": 10,
"redemptions": [
21, 22, 23
]
}
{
"message": "Redemption reversal complete"
}
Errors will be displayed in the following format and will be returned along with a 422 http response code. In cases where a single field has multiple errors, it is most likely the case that the first message is the error you need to look out for.
{
"message": "The given data was invalid.",
"errors": {
"redemptions": [
"Please provide a valid list of redemptions to reverse"
]
}
}