Yes, Shoppable supports both dollar-off ($) and percent-off (%) promo codes. The specific terms of a promo code, including whether it can be used once or multiple times, are determined by the code itself.
Yes, Shoppable supports both dollar-off ($) and percent-off (%) promo codes. The specific terms of a promo code, including whether it can be used once or multiple times, are determined by the code itself.
| Code Type | Description | Example |
|---|---|---|
| Dollar-Off ($) | A fixed monetary amount is deducted from the order total. | $10 off your order |
| Percent-Off (%) | A percentage of the subtotal is deducted from the order total. | 20% off your order |
Usage Options
Each promo code can be configured with one of the following usage limits:
-
One-Time Use per Email: The discount can only be used once per unique customer email address.
-
Unlimited Use: The discount can be applied multiple times by any customer, subject to the code’s active date range and other conditions set by the merchant.
General Notes
-
Only one promo code may be applied per order.
-
Promo codes must be entered at checkout before payment is submitted.
-
Expired or invalid codes will not be accepted.
- Promo codes are applied to the subtotal exclusive of any shipping, fees, and taxes.
- Promo Codes are promotions offered by you, the brand or website owner. These are not manufacturer coupons or retailer coupons.
How to Set Up a Promo Code Campaign:
All promo codes must be setup and activated by Shoppable. If you'd like to run a promo code, please reach out to your Shoppable Customer Success Manager (CSM).
Implementing Coupons for Shoppable DTC Lite v6
You have full control over the coupon configuration and marketing budget, and your CSM will assist with the setup process.
What fields can I control during the creation of the coupons?
Coupon Configuration Controls
couponCode
Name of code for coupon, coupon codes cannot include spaces.
discountType
Type of discount applied during checkout, discountType can have only accept 2 values “fixed” dollar off and “percentage” discount.
discountValue
Amount to be discounted at checkout, for example if discountValue is 10, and discountType is “fixed” amount discount will be $10.00, if discountType is “percentage” the amount discounted will be 10%
usageType
Defines if coupons can be used once or multiple times, usageType can only accept 2 values “SINGLE_USE” for one time used and “MULTI_USE” can be used multiple times within a given date range.
startDate
Sets start date for when the coupon should be active.
expirationDate
Sets expiration date for when the coupon should no longer be active.
active
Sets a coupon to be actively applied within your checkout.
Here is an example of a created Coupon object.
{
"couponCode": "PROMO10",
"discountType": "fixed",
"discountValue": 10,
"usageType": "MULTI_USE",
"startDate": "10/30/2025",
"expirationDate": "11/01/2025",
"active": true
}
How can I check to see what coupons are active?
You can utilize Shoppable’s coupons GET endpoint call to retrieve all active coupons associated to your account:
Staging URL: https://cloud.staging.shoppable.com/coupons
Production URL: https://cloud..shoppable.com/coupons
TYPE: GET
Headers: {
Authorization: “Bearer <YOUR_TOKEN_HERE>”,
x-shoppable-secret: “<YOUR_SECRET_HERE>”
}
Response
{
"success": true,
"message": "Active coupons retrieved successfully",
"coupons": [
{
"id": "6903bb4eab0f67db02196227",
"couponCode": "10WELCOME",
"discountType": "percentage",
"discountValue": 10,
"startDate": "2025-10-30T00:00:00.000Z",
"expirationDate": "2025-11-07T00:00:00.000Z",
"createdAt": "2025-10-30T19:23:58.631Z",
"updatedAt": "2025-10-30T19:23:58.631Z"
},
{
"id": "6903e48dab0f67db02196253",
"couponCode": "PROMO10",
"discountType": "fixed",
"discountValue": 10,
"startDate": "2025-10-30T00:00:00.000Z",
"expirationDate": "2025-11-07T00:00:00.000Z",
"createdAt": "2025-10-30T22:19:57.106Z",
"updatedAt": "2025-10-30T22:19:57.106Z"
}
],
"metadata": {
"total": 2,
"returned": 2
}
}