Enable or disable a coupon
Change coupon status by ID. Enable a coupon: Only disabled coupons can be enabled. Disable a coupon: Only not expired coupons can be disabled.
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Headers
A header used by fabric to identify the tenant making the request. You must include tenant id in the authentication header for an API request to access any of fabric’s endpoints. You can retrieve the tenant id , which is also called account id, from Copilot. This header is required.
24
x-fabric-channel-id identifies the sales channel where the API request is being made; primarily for multichannel use cases. The channel ids are 12 corresponding to US and 13 corresponding to Canada. The default channel id is 12. This field is required.
A unique identifier obtained from Copilot for the System app in the fabric ecosystem, essential for OpenID Connect authentication flows.
A unique request ID.
Path Parameters
A 24-character system-generated coupon ID.
Body
Toggle data request
True: promotion will be enabled<br>False: promotion be disabled
Response
The details of toggled coupons.
A 24-character system-generated coupon ID.
The name of the coupon.
Coupon status
ACTIVE
, SCHEDULED
, DISABLED
, EXPIRED
The start time of a coupon.
The end time of a coupon.
Coupon types. The options are:<br>Product: Also referred to as SKU promotion. Coupon discount is applied on SKUs based on the value mentioned in the discounts
array of the request body.<br>CART: Also referred to as cart promotion. Discount is applied on the minimum order amount of the cart based on the ORDER_VALUE
mentioned in the condition
object of the request body.<br>QUANTITY: Discounts are applied on items based on the quantity requirement set in the promotion.<br>SHIPPING: Shipping promotion provides discounts on the shipping cost.<br>BUYGET: BuyGet promotion specifies the Buy conditions and corresponding Get discounts.<br>SPEND_GET: SpendGet promotion specifies the total order value required to qualify for discounts and the discounts applicable based on the order value.
PRODUCT
, CART
, QUANTITY
, SHIPPING
, BUYGET
, SPEND_GET
Record's creation time
Record's last updated time
The total number of coupon codes.
Coupon execution order
0 < x < 5
Defines the rules for how a promotion can be combined with other promotions. This field determines whether a specific promotion can be applied in conjunction with other active promotions during a transaction or if it must be used exclusively. If configured, stackingType
will have precedence over the isStackable
and isAlwaysApplied
Possible values: - STACKABLE
: This promotion can be combined with other stackable promotions, allowing multiple
discounts to be applied together. The order in which stackable promotions are applied
is determined by the level
field, with promotions having a higher priority (lower numeric value)
being applied before those with a lower priority.
EXCLUSIVE
: This promotion can't be combined with any other promotions. Thelevel
field is used to determine which exclusive promotion will be evaluated and applied first. Once an exclusive promotion is applied, no other promotions can be used in the same transaction.TYPE_EXCLUSIVE
: This promotion can't be combined with other promotions of the same type. Thelevel
field is used to determine which promotion within the same type will be evaluated and applied first.UNIVERSAL
: This promotion can be combined with any other promotions without restrictions. Universal promotions will be evaluated last.
STACKABLE
, EXCLUSIVE
, TYPE_EXCLUSIVE
, UNIVERSAL
true
indicates that the coupon can be stacked, meaning a coupon can be applied with other coupons, and false
indicates that the coupon can't be applied with other coupons.
Set true
to always apply the promotion, even on non-stackable promotions, or false
to apply promotion based on configured conditions.
Determines whether the coupon is valid for single use or for multiple uses. The options are:<br>SINGLE_USE: The coupon can be used only once.<br>MULTI_USE: The coupon can be used multiple times.
MULTI_USE
, SINGLE_USE
An array of available coupon codes.
Message description for the promotion
A placeholder for additional attributes, in name-values pairs.
Was this page helpful?