Unclaiming vouchers

Returns an OK code and echoes the updated voucher details including the new voucher_status field. A sample is below:

  {
    "result": {
        "code": 1,
        "status": "ok"
    },
    "results": {
         "voucher_key": "a8c34c86c136e5ddf0ad374e140aa1e3504ebbf23d76d84788677268fd99b809",
         "voucher_id": 40577,
         "voucher_status": "generated",
         "voucher_locked": false,
         "campaign_id": 2,
         "campaign_type": "cashback",
         "campaign_title": "20 EUR voucher for every 200 EUR spent",
         "voucher_expiry_datetime_utc": "2050-01-01 00:00:00",
         "voucher_expiry_seconds_remaining": 1013819756,
         "voucher_currency_id": 2,
         "voucher_currency_symbol": "\u20ac",
         "voucher_amount_original": 20,
         "voucher_amount_redeemed": 0,
         "voucher_amount": 20,
         "voucher_text": "Your new voucher, enjoy!",
         "user_id": 1,
         "user_entity_card": {
             "type": "regular",
             "code": "1"
         },
         "result_type": "unclaim-voucher"
    }
  }

Overview

• Call name: unclaim-voucher
• Endpoint URL: https://api0.spaaza.com/unclaim-voucher
• Request methods: POST or PUT
• Request Content-Type: multipart/form-data or application/x-www-form-urlencoded
• Response Content-Type: application/json
• Auth required: yes

Unclaims a voucher (variable price or other kind of voucher) which has been claimed by a user.

Permissions and Authentication

This API call requires a valid Spaaza session. The session can be as follows:

• User authentication: a session generated by an end-user login.
• Admin authentication: the performing user needs to be logged in and have write access to the entity (business or chain) to which the user is connected.
• Privileged authentication: the use of privileged authentication is permitted for this endpoint.

Note that if a voucher is locked it can only be unclaimed using Admin or Privileged authentication.

HTTP Parameters

The following HTTP parameters can be passed to the API:

Permissions

This API call requires write permissions for the user in the case of admin authentication.