HomeGuidesRecipesAPI ReferenceChangelog
GuidesAPI ReferenceCustomer Help CenterLog In
API Reference

Introduction

Coupon Types

Xola offers four varieties of coupons:

  1. Discount: Reduces the order amount by a percentage or absolute value.
  2. Unlock: Specify an ad-hoc order amount.
  3. Demographic Discount: Reduces the order amount by an absolute value based on the quantity of guests.
  4. Buy X Get Y: Advanced demographic discount coupon that helps incentivize group bookings.
  5. Voucher: Applied as a payment method (unlike other types which are applied as a discount). Vouchers are a great way to handle campaigns from daily deal sites like Groupon.

Taxes & Fees

All Coupons, with the exception of Vouchers, are applied before taxes & fees. Vouchers are applied after taxes & fees; just like a method of payment.

Purchase Restrictions

All coupon types support the ability to place the following restrictions at redemption:

  1. Purchase Window: Limits the dates within which this coupon can be redeemed.
  2. Arrival Window: Limits the arrival date on which the activity takes place.
  3. Listing Restriction: Limits the coupon to a subset of your listings.

Coupon Codes

A coupon cannot be directly used. It must have "codes" associated with it. A code may be configured to be a limited use, or unlimited use. Xola will keep track of the number of code usages.

{
  "id": "5acc4fa307876c4f798b4567",
  "name": "Winter Sale",
  "amount": 20,
  "type": "discount",
  "algorithm": "percent",
  "source": "xola",
  "seller": {
    "id": "57e4a620c683b1c01e8b4575"
  },
  "bookBySchedule": {
    "id": "5b05c8ed07876c8a108b457e",
    "repeat": "weekly",
    "days": [0, 1, 2, 3, 4, 5, 6],
    "start": "2018-08-31T15:00:00+00:00",
    "end": "2018-12-31T14:59:59+00:00",
    "type": "available",
    "timeRanges": [],
    "blackouts": []
  },
  "arrivalSchedule": {
    "id": "5b05c8ed07876c8a108b457f",
    "repeat": "weekly",
    "days": [0, 1, 2, 3, 4, 5, 6],
    "start": "2018-10-31T15:00:00+00:00",
    "end": "2018-12-31T14:59:59+00:00",
    "type": "available",
    "timeRanges": [],
    "blackouts": [
      {
        "repeat": "weekly",
        "days": [2],
        "start": "2018-12-24T15:00:00+00:00",
        "end": "2018-12-25T14:59:59+00:00",
        "type": "unavailable",
        "timeRanges": [],
        "id": "5b05c8ed07876c8a108b4580"
      }
    ],
  },
  "createdAt": "2018-04-10T05:46:11+00:00",
  "createdBy": {
    "id": "4f293e17536e86bc66000000"
  },
  "updatedAt": "2018-05-23T20:02:53+00:00",
  "experiences": {
    "all": true,
    "experiences": []
  },
  "tags": [
    {
      "system": true,
      "id": "winter is coming"
    }
  ]
}