Sign in
Coupons

Update Coupon

Updates a coupon.

put/v1/coupons/{coupon_id}

Path parameters

coupon_idstring required

Request body

discount_percentinteger

The discount percent for the coupon

bonus_percentinteger

The bonus percent for the coupon

bonus_fixedinteger nullable

The fixed bonus amount for the coupon

discount_amount_usdinteger

The discount amount in USD for the coupon

expires_atinteger

The expiration date of the coupon

applicable_item_idsstring[]

The applicable item IDs

category_idstring

The coupon category ID

min_amountinteger

Require a minimum order amount to apply the coupon

max_redemptionsinteger

Limit the number of times this code can be redeemed

max_redemptions_per_userinteger

Limit the number of times a user can redeem the coupon

is_stackable_with_bonus_couponsboolean

Allow stacking with bonus coupons

stackable_bonus_limit_percentinteger

Limit the bonus percent when stacking with bonus coupons

is_stackable_with_discount_couponsboolean

Allow stacking with discount coupons

stackable_discount_limit_percentinteger

Limit the discount percent when stacking with discount coupons

store_item_discount_limit_percentinteger

Limit the combined store item and coupon discount percent

store_item_bonus_limit_percentinteger

Limit the combined store item and coupon bonus percent

start_atinteger

The timestamp when the coupon becomes valid

end_atinteger

The timestamp when the coupon ceases to be valid

player_idsstring[]

The player IDs that can redeem the coupon

exclude_player_idsstring[]

The player IDs that cannot redeem the coupon

namestring

The name of the coupon

Response

Successful Response

discount_percentinteger

The discount percent for the coupon

bonus_percentinteger

The bonus percent for the coupon

bonus_fixedinteger nullable

The fixed bonus amount for the coupon

discount_amount_usdinteger

The discount amount in USD for the coupon

expires_atinteger

The expiration date of the coupon

applicable_item_idsstring[]

The applicable item IDs

category_idstring

The coupon category ID

min_amountinteger

Require a minimum order amount to apply the coupon

max_redemptionsinteger

Limit the number of times this code can be redeemed

max_redemptions_per_userinteger

Limit the number of times a user can redeem the coupon

is_stackable_with_bonus_couponsboolean

Allow stacking with bonus coupons

stackable_bonus_limit_percentinteger

Limit the bonus percent when stacking with bonus coupons

is_stackable_with_discount_couponsboolean

Allow stacking with discount coupons

stackable_discount_limit_percentinteger

Limit the discount percent when stacking with discount coupons

store_item_discount_limit_percentinteger

Limit the combined store item and coupon discount percent

store_item_bonus_limit_percentinteger

Limit the combined store item and coupon bonus percent

start_atinteger

The timestamp when the coupon becomes valid

end_atinteger

The timestamp when the coupon ceases to be valid

player_idsstring[]

The player IDs that can redeem the coupon

exclude_player_idsstring[]

The player IDs that cannot redeem the coupon

namestring required

The name of the coupon

codestring required

The code of the coupon

type'bonus' | 'discount' | 'free_item' | 'vc' | 'non_benefit' | 'discount_fixed' | 'discount_reward_point' required
idstring required

The unique identifier of the coupon

current_balance_usdinteger

The current balance in USD for fixed discount coupon type

Changes

Changed in 2 of the 17 revisions of this API.32

  • fbb6b66272c81See the full diff
    • ○

      added the optional property //// to the response with the status

      response-optional-property-added

  • ef61f771db1d31See the full diff
    • ●

      the / request property's maxLength was set to 32

      request-property-max-length-set

    • ●

      the request property's maxLength was set to 32

      request-property-max-length-set

    • ●

      the /// request property's maxLength was set to 32

      request-property-max-length-set

    • ○

      added the optional property // to the response with the status

      response-optional-property-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog