LogoLogo
Build appsContact API support
Discounts and tips
  • Build apps
  • Site Templates
  • API Reference
  • Changelog
Discounts and tips
  • Discounts and tips overview
  • Add discounts to the store
    • Automatic discounts (promotions)
    • Discount coupons
    • Bulk discount prices for products
    • Discounts calculated on your server
  • Add tips or surcharges to the store
    • Add tips selection to the checkout
    • Apply hidden surcharges
    • Calculate surcharges on your server
  • Customize discounts
    • Set up "Buy X - Get Y" promotions
    • Set up "Free shipping" promotions
    • Set up start and end dates for discounts
    • Limit discounts to customer groups
    • Limit discounts by products and categories
    • Limit the number of discount coupon uses

Lightspeed® 2025

On this page

Was this helpful?

  1. Customize discounts

Limit the number of discount coupon uses

PreviousLimit discounts by products and categories

Last updated 2 months ago

Was this helpful?

Discount coupons can additionally be limited by the number of their uses. This allows you to create one-time use coupons for customers.

If you have an existing discount coupon, you can limit its usage to new or regular customers only with the following API call:

PUT /api/v3/STOREID/discount_coupons/DISCOUNTCOUPONID
Host: app.ecwid.com
Content-Type: application/json
Authorization: Bearer secret_token

{
    "usesLimit": "ONCEPERCUSTOMER"
}

where usesLimit must be one of:

  • UNLIMITED - no uses limit (use it to remove the limitation).

  • ONCEPERCUSTOMER - discount coupon can be applied only once by every customer. Unique customers are defined by the email they enter at the checkout.

  • SINGLE - discount coupon can be applied only once.

Change STOREID with your store ID, DISCOUNTCOUPONID with the discount coupon ID (), and the secret_token with the secret access token of your app.

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

find discount coupon ID
instructions