Generate bundle-specific discount code

Creates a Shopify discount code specifically for a subscription bundle. This endpoint generates unique, single-use or multi-use discount codes tied to bundle purchases.

Full behavior, validation rules, and side effects

Key Features:

• Bundle-Specific Codes: Discounts that apply only to specific bundles
• Flexible Discount Types: Percentage off, fixed amount off, or free shipping
• Usage Limits: Single-use, limited use, or unlimited codes
• Expiration Dates: Set validity periods for promotional campaigns
• Minimum Requirements: Minimum purchase amount or quantity thresholds
• Customer Eligibility: Restrict to specific customer segments or tags

Discount Configuration:

• Code Format: Custom code or auto-generated random code
• Discount Value: Percentage (e.g., 15%) or fixed amount (e.g., $10)
• Start/End Dates: Campaign duration controls
• Usage Limit: Max number of times code can be used
• Once Per Customer: Prevent code reuse by same customer
• Bundle Association: Links discount to specific bundle token

Use Cases:

• Create promotional codes for bundle launches
• Generate unique codes for influencer campaigns
• Offer first-time subscriber discounts on bundles
• Seasonal or holiday bundle promotions
• Referral program discount codes
• Partner/affiliate exclusive bundle offers

Authentication: Requires API key authentication via X-API-Key header or api_key parameter

PUT /api/external/v2/subscription-bundlings/discount/{token}

Generate bundle-specific discount code

cURL

curl --request PUT \
  --url https://membership-admin.appstle.com/api/external/v2/subscription-bundlings/discount/{token} \
  --header 'Content-Type: application/json' \
  --data '
{
  "cart": {
    "token": "<string>",
    "note": {},
    "attributes": {},
    "original_total_price": 123,
    "total_price": 123,
    "total_discount": 123,
    "total_weight": 123,
    "item_count": 123,
    "items": [
      {
        "id": 123,
        "properties": {},
        "quantity": 123,
        "variant_id": 123,
        "key": "<string>",
        "title": "<string>",
        "price": 123,
        "original_price": 123,
        "discounted_price": 123,
        "line_price": 123,
        "original_line_price": 123,
        "total_discount": 123,
        "discounts": [
          {}
        ],
        "sku": "<string>",
        "grams": 123,
        "vendor": "<string>",
        "taxable": true,
        "product_id": 123,
        "product_has_only_default_variant": true,
        "gift_card": true,
        "final_price": 123,
        "final_line_price": 123,
        "url": "<string>",
        "featured_image": {
          "aspect_ratio": 123,
          "alt": "<string>",
          "height": 123,
          "url": "<string>",
          "width": 123
        },
        "image": "<string>",
        "handle": "<string>",
        "requires_shipping": true,
        "product_type": "<string>",
        "product_title": "<string>",
        "product_description": "<string>",
        "variant_title": {},
        "variant_options": [
          "<string>"
        ],
        "options_with_values": [
          {
            "name": "<string>",
            "value": "<string>"
          }
        ],
        "line_level_discount_allocations": [
          {}
        ],
        "line_level_total_discount": 123
      }
    ],
    "requires_shipping": true,
    "currency": "<string>",
    "items_subtotal_price": 123,
    "cart_level_discount_applications": [
      {}
    ]
  }
}
'

200

{
  "discountCode": "<string>",
  "errorMessage": "<string>",
  "discountNeeded": true
}

Headers

X-API-Key · string

Path Parameters

token · string · required

Bundle token identifier

Query Parameters

api_key · string

API Key (Deprecated - Use Header X-API-Key instead)

Body

application/json

Discount code configuration including code, value, type, and validity

cart · object

Show child attributes

Response

200

application/json

Discount code successfully created in Shopify

discountCode · string

errorMessage · string

discountNeeded · boolean