Key Distinction

Subscriptions are initiated and managed separately from the standard one-time purchase checkout flow (POST /orders). Creating a subscription typically involves the POST /subscriptions endpoint and a subsequent mandate/payment step, bypassing the standard cart-to-order conversion for the subscription itself.

Prerequisites

  • Payment Gateway: Juspay integration is required for managing recurring payment mandates.
  • Product Configuration: Products intended for subscription must have plans defined in the subscription array within their Catalog data.

Key Features:

  • Standard & Custom Plans
  • Billing & Shipping Cycles
  • Trial Periods (Digital)
  • Lifecycle Management (Create, View, Update, Pause, Revoke via API)
  • Coupon Integration (Applied during POST /subscriptions)
  • (Usage-Based Billing - Future)

Core Concepts

Subscription Initiation Flows

There are two primary ways a user initiates a subscription:

Subscription API Endpoints