StripeSubscriptionCreateRequest

Body for POST /stripe/subscriptions. The platform validator (subscription_creation) is authoritative and expects customerId + items[]; the flattened priceId form is the shape currently sent by the LDS client. Provide either items or priceId.

customerIdstringrequired

Stripe customer id (cus_…) to attach the subscription to.

Possible values: non-empty

Example: cus_QabC123def456

priceIdstring

Convenience single-price form used by LDS. Equivalent to items: [{ priceId }].

Possible values: non-empty

Example: price_1NXYZabcDEF

items object[]

Platform-authoritative subscription items. Each item carries a Stripe Price id and optional discounts.

Array [

priceIdstringrequired

Possible values: non-empty

Example: price_1NXYZabcDEF

discounts object[]

Array [

couponIdstring

Possible values: non-empty

discountIdstring

Possible values: non-empty

promotionCodeIdstring

Possible values: non-empty

]

]

allowDoubleSubscriptionsboolean

When false, the platform rejects a price that already appears on an active subscription for the customer (STRIPE_DUPLICATE_SUBSCRIPTION_ITEM).

StripeSubscriptionCreateRequest

{
  "customerId": "cus_QabC123def456",
  "priceId": "price_1NXYZabcDEF",
  "items": [
    {
      "priceId": "price_1NXYZabcDEF",
      "discounts": [
        {
          "couponId": "string",
          "discountId": "string",
          "promotionCodeId": "string"
        }
      ]
    }
  ],
  "allowDoubleSubscriptions": true
}