Discount coupons

Discount coupons allow you to set up non-automated discounts – they must be manually activated by customers at the checkout. Coupons are useful when you need personalized discounts unavailable to the general store audience.

Add a new discount coupon to the store

The first step here is to create a discount coupon for your store. However, a discount coupon won't work by itself.

When you have the coupon, you'll need to place its code somewhere on the storefront or reach out to customers in newsletters/emails.

If you don't yet have an app for Ecwid API access, start with the following instructions.

Make sure your app has the create_discount_coupons access scope required to create new coupons.

Example request for creating a new discount coupon:

POST /api/v3/STOREID/discount_coupons HTTP/1.1
Host: app.ecwid.com
Content-Type: application/json
Authorization: Bearer secret_token

{
    "name": "First order 10% OFF",
    "code": "FIRST",
    "status": "ACTIVE",
    "discountType": "PERCENT",
    "discount": 10,
    "usesLimit": "ONCEPERCUSTOMER",
    "applicationLimit": "NEW_CUSTOMER_ONLY"
}

Change STOREID with your store ID and secret_token with the secret access token of your app to add a new active discount coupon to your store.

The example request allows new customers to receive a 10% discount on their first order.

Customize discount coupons

You can limit discount coupons in products/categories they apply to, set up use limits and more:

Last updated

Was this helpful?