Skip to main content
Converts a cart to a subscription order at checkout. The cart must contain exactly one subscription line item with quantity 1. Line item metadata is the authoritative source for subscription configuration. Mixed carts (subscription and one-time items together) are not supported in the current version. Standard one-time checkout is not affected by this route.
This endpoint is idempotent — if the completed order is already linked to a subscription, the existing subscription is returned instead of creating a duplicate.

​
POST /store/carts/:id/subscribe

​
Path parameters

​
string
required
Cart ID.

​
Line item metadata contract

The following metadata fields must be set on the subscription line item before calling this endpoint.
​
boolean
required
Must be true to mark the line item as a subscription.
​
string
required
Billing interval. One of week, month, or year.
​
number
required
Billing cadence as a positive integer.

​
Optional cart metadata

​
string
When present, must be "subscription". Mixed purchase mode is not supported.
Line item metadata example

​
Response

Returns the created subscription on success. If the order is already linked to a subscription (idempotent re-call), returns the existing subscription. When the subscription is created for the first time, Reorder also appends a subscription.created entry to the Activity Log. The event is recorded with the storefront customer as the actor so operators can see that the subscription originated from checkout.

​
Errors