Introducing our brand new Rules Engine —
Read the docs
LogoLogo
Core APIOther APIsChangelog
How-tos
How-tos
  • Introduction
  • Product discovery
    • Product listing page
    • Product page
  • Placing orders
    • Shopping cart
      • Creating a shopping cart
      • Adding products to cart
      • Updating cart quantities
      • Removing products from cart
      • Displaying the cart summary
    • Checkout
      • Adding the customer
      • Adding a billing address
      • Adding a shipping address
      • Selecting a shipping method
      • Selecting a payment method
      • Adding a payment source
      • Adding a gift card or coupon
      • Placing the order
    • Subscriptions
      • Configuring a subscription model
      • Selecting the source order
      • Generating the subscriptions
      • Updating the subscriptions
    • Payments
      • Adyen
        • Adding the payment source
        • Sending back the payment details
        • Configuring the notification webhooks
        • Reusing the payment source
      • Axerve
        • Adding the payment source
        • Updating the payment intent
      • Braintree
        • Adding the payment source
        • Sending back the payment method nonce
        • Accepting local payments
        • Reusing the payment source
      • Checkout.com
        • Adding the payment source
        • Getting the payment details
        • Refreshing pending transactions
        • Reusing the payment source
      • Klarna
        • Adding the payment source
        • Sending back the authorization token
        • Reusing the payment source
      • PayPal
        • Adding the payment source
        • Preparing the payment for execution
      • Stripe
        • Adding the payment source
        • Refreshing the payment source
        • Reusing the payment source
      • Manual payments
        • Adding a wire transfer payment source
      • External payments
        • Adding the payment source
        • Reusing the payment source
    • Auto-capture
      • Enabling the auto-capture
      • Limiting the auto-capture amount
  • inventory
    • Inventory strategies
      • No split
      • Split shipments
      • Split by line items
      • Ship from first available (or primary)
      • Ship from primary
  • FAQ
    • Environments and initial setup
    • Authentication and access tokens
On this page
  1. Placing orders

Subscriptions

How to generate scheduled recurring orders from a source order

PreviousPlacing the orderNextConfiguring a subscription model

Last updated 1 year ago

Subscriptions allow merchants to offer regular purchases of a product or group of products, resulting in predictable, recurring revenue and increasing both acquisition and retention. A flexible subscription model provides an affordable way for consumers to access what they want when they want it and a direct-to-consumer experience that attracts, retains, and benefits customers long-term.

Commerce Layer's are defined by market, thus market-specific subscription strategies. Commerce Layer lets you handle subscription generation both (the recommended and most common usage) and .

Data model

Check the related and explore the flowchart that illustrates how the order subscription resource relates to the other API entities.

This guide will walk you through the steps you need to follow to correctly setup the available subscription frequencies and strategies for your markets and trigger automatic subscription generation starting from a source order:

  1. Create a and associate it with a market.

  2. Create a source order containing at least one line item that has a and place it.

  3. Update the source order by sending a specific to start the order subscription generation.

  4. Eventually, edit the automatically generated subscriptions to change the next subscription runs.

Commerce Layer's subscription management can be offered to only. All the API calls in this guide are supposed to be authenticated with a customer token obtained via the (unless where specified differently). See the and sections of our documentation if you need more information on how to get an access token for your client or about the different types of credentials you can get.

subscriptions
ER diagram
automatically
manually
subscription model
frequency
trigger attribute
registered customers
password flow
Authentication
Applications