Skip to main content
Version: 8.5.x

Coupons

A coupon is a code, consisting of letters or numbers that a shopper can apply to an order. When a coupon is applied to an order, it can trigger a promotion which in turn discounts or adds additional incentives to the order.

Coupons for an order can be managed through the coupon info resource. This is where coupons that are applied to an order are listed, as well as a form to apply new coupons. Each coupon is linked to the promotions it triggered. If no promotions were triggered then no promotion link will be present.

Coupons for a purchase are coupons that were applied to the shopper’s purchase.

Read Coupons Applied To Order​

Read coupons applied to the order.

Workflow​

  1. Start with order
  2. GET the link with rel: couponinfo
  3. GET the link with rel: coupon
  4. Render the response

Response Fields​

Type: coupons.coupon​

NameDescriptionType
codeThe coupon code.string

Apply Coupon To Order​

Apply a coupon to the order.

Workflow​

  1. Start with order
  2. GET the link with rel: couponinfo
  3. GET the link with rel: couponform
  4. Fill out the form
  5. POST the form using the link with rel: applycouponaction

Request Fields​

Type: coupons.coupon​

NameDescriptionType
codeThe coupon code.string

Remove A Coupon From Order​

Remove an applied coupon from the order.

Workflow​

  1. Start with order-coupon
  2. DELETE order-coupon

Read Coupons Applied To Purchase​

Read a coupon applied to the purchase.

Workflow​

  1. Start with purchase
  2. GET the link with rel: coupons
  3. GET the link with rel: element
  4. Render the response

Response Fields​

Type: coupons.coupon​

NameDescriptionType
codeThe coupon code.string