Skip to main content
PUT
Update discount code status

Body

application/json

Request containing customer ID, discount code, and new status

customerId
integer<int64>
required

Shopify customer ID (numeric). Identifies which customer owns the discount code. Used to verify the discount code belongs to this customer before updating. Example: 67890

Example:

67890

discountCode
string
required

The discount code to update. Case-insensitive. Must be a valid loyalty discount code that belongs to the specified customer. Examples: "LOYALTY15OFF", "VIP20", "WELCOME10"

Maximum string length: 100
Example:

"LOYALTY15OFF"

status
enum<string>
required

New status for the discount code. Valid values:

  • USED: Mark code as used after checkout (most common)
  • SUBSCRIPTION_ACTIVE: Mark code as active for subscription renewals
  • UNUSED: Reset code to unused state (use carefully)
  • EXPIRED: Manually expire a code

Status transitions:

  • UNUSED → USED: Normal checkout flow
  • UNUSED → SUBSCRIPTION_ACTIVE: Subscription created
  • SUBSCRIPTION_ACTIVE → USED: Subscription ended
  • Any → EXPIRED: Manual expiration

Note: Cannot mark already USED codes as USED again.

Available options:
USED,
UNUSED,
REFUNDED,
EXPIRED,
SUBSCRIPTION_ACTIVE,
CANCELED,
USED,
UNUSED,
SUBSCRIPTION_ACTIVE,
EXPIRED
Example:

"USED"

Response

Discount code status successfully updated

createAt
string<date-time>
required
customerId
integer<int64>
required
discountCode
string
required
shop
string
required
status
enum<string>
required
Available options:
USED,
UNUSED,
REFUNDED,
EXPIRED,
SUBSCRIPTION_ACTIVE,
CANCELED
amount
number<double>
description
string
discountCodeId
string
expireDate
string<date-time>
id
integer<int64>
lastExpiryReminderSentDate
string<date-time>
orderId
integer<int64>
orderName
string
pointRedeemRuleId
integer<int64>
pointTransactionId
integer<int64>
productData
string
rewardType
enum<string>
Available options:
STORE_CREDIT,
DISCOUNT_CODE,
POINTS
usageCount
integer<int64>
usedAt
string<date-time>
variantId
integer<int64>