Interface Coupon

Attributes linked to this coupon.

Codes linked to this coupon.

Valid item categories for this coupon.

POST here to generate random coupon codes.

Store this coupon belongs to.

This resource.

If this coupon can be combined with other coupons, check this check box. If this box is unchecked, the coupon will not be added to the cart if another coupon is already in the cart. Similarly, if this coupon is added first, no other coupons will be able to be added to the cart.

This is the string that determines the tiers and amounts that make up your discount. For example, 2-.50|10-3|50-5 means "between 2 and 9 is discounted by .5 per product, 10 and 49 by 3 per product and 50 and over by 5 per product. If you're doing a quantity discount, it will compare against the quantity of products in the order. If you're doing a price based discount, it will compare against the price of the products in the order. Please see the documentation for more information: Coupons and Discounts

This specifies what type of discount will be applied. Will it be a percentage discount or an amount discount based on either the product price or the product quantity?

Auto-apply coupons only. This coupon will be automatically applied when a customer record matches this query. Example: attributes:name[auto_apply_coupons]=1.

Set to true to enable auto-apply functionality.

Auto-apply coupons only. This coupon will be automatically applied when a subscription includes a product with one of the codes in the list. Wildcards are allowed just like in product code restrictions. Example: code_1,code_2,sku_*,abc.

The date this resource was created.

The date this resource was last modified.

If you want this coupon's usage to be limited by a time frame or end in the future, add an end date here. To clear it out, set an empty value or use 0000-00-00.

Set to true if you want to ensure category discounts are not applied for an order that uses this coupon.

Set to true if you want to ensure line item discounts are not applied to any products for an order that uses this coupon.

This param is using for coupon calculation amount for tax inclusive mode. Optional. [0..1].

Set to true to apply taxes before this coupon's discount is applied. Check with your tax professional if you have questions about how you should calculate taxes.

This restricts the usage of a coupon code based on an item's item_option key and value. Valid input is a json object with the keys matching the item_option.name, and the value an array of comma-separated matching or partially matching strings, using * as a wild card at the beginning, end, or middle of the string. So {"author": ["Agatha*", "*brown"]} will match the item where item option "author" is "Agatha Christie" or "Dan Brown". It would not match an item with no "author" option, or with an "author" of "John Doe". Optional. 6000 characters or less.

Set to true if you want to allow your customers to use multiple coupon codes from this coupon on the same order. If false, the customer will see an error if they try to add another coupon code if one for this coupon is already in the cart.

The name of this coupon. This will be for your own use and displayed to the customer.

This is the total number of times this coupon is allowed to be used. This can be helpful for promotions that involve offering a discount to the first 100 customers, as an example, even though more than 100 coupon codes were given out. Leave as 0 to ignore this feature.

If you want to limit the number of uses per individual coupon code, enter that number here. If you want each code to only be used once, enter 1 here. Leave as 0 to ignore this feature.

If each customer is only allowed to use this coupon once, enter 1 here. This is based off of the customer email address, not a payment method, ip address, shipping address or browser cookie. Leave as 0 to ignore this feature.

For informational purposes, this shows you how many times this coupon has already been used.

If you want to limit which products can use this coupon, you can enter a comma separated listed of product codes or partial product codes using * as a wild card at the beginning or end of the value. So abc123, fun_*, *-small would match abc123, fun_ and fun_times, and example-small. It wouldn't match abc12, abc1234, fun, or good-smalls.

Enables sharing coupon codes between coupons.

If you want this coupon's usage to be limited by a time frame or start in the future, add a start date here. To clear it out, set an empty value or use 0000-00-00.