Coupons

Create Coupon

Changed on

Creates a new coupon.

post/v1/coupons

Request

  • Base URL
    https://api.aghanim.com/s2s
  • URL
    https://api.aghanim.com/s2s/v1/coupons
  • Auth
    HTTP bearer

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 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

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

  • 84e35f2954bfRevision changes
    • warning

      added the new store enum value to the /////// response property for the response status

    • warning

      added the new store enum value to the ///// response property for the response status

    • warning

      added the new store enum value to the /// response property for the response status

    • info

      added the new store enum value to the request property ///

    • info

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

  • d06893be93ccRevision changes
    • warning

      added the new rolling enum value to the // response property for the response status

    • info

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