उत्पाद संग्रह

Product Collections संबंधित products (जैसे Starter, Pro और Enterprise plans) को एक umbrella के अंतर्गत समूहित करते हैं। सभी विकल्पों को एक checkout में प्रदर्शित करें, upgrade/downgrade paths निर्धारित करें और customers को Customer Portal से सीधे plans बदलने दें।

प्रोडक्ट कलेक्शन चेकआउट पृष्ठ का स्क्रीनशॉट जिसमें कई उत्पाद दिखाई दे रहे हैं

प्रमुख हाइलाइट्स

Product Collections आपको ये करने देते हैं:

व्यवस्थित management के लिए संबंधित products (plans, tiers, pricing options) को समूहित करें।
कई products शामिल करें, जैसे Starter, Pro और Lifetime, जिनमें से प्रत्येक का अपना pricing model हो।
सभी products को एक checkout view में प्रदर्शित करें, ताकि customers तुलना करके अपना पसंदीदा plan चुन सकें।
Customers को Customer Portal के माध्यम से उसी collection में मौजूद products के बीच upgrade या downgrade करने दें।
नियंत्रित करें कि कौन से products दिखाई दें, किस क्रम में दिखाई दें और checkout पर कौन सा pre-selected हो।

Product Collection बनाना

Dashboard या API के माध्यम से collections बनाएँ और manage करें।

Create the collection

Collection को name और optional description के साथ परिभाषित करें। Checkout में इसे दर्शाने के लिए एक image upload करें।

Screenshot of the Product Collection creation form in the dashboard showing fields for name, description, and image upload

Collection fields:

Name (आवश्यक): Display name (जैसे, “SaaS Plans”, “License Tiers”)।
Description (वैकल्पिक): Checkout में दिखाई जाने वाली संक्षिप्त व्याख्या।
Image (वैकल्पिक): Collection के लिए visual branding।

Add products to the collection

अपने collection में मौजूदा products जोड़ें। बेहतर structure के लिए उन्हें groups में व्यवस्थित करें।

Screenshot of the Product Collection products page showing a list of products and the ability to add them to the collection

Product organization:

Groups: Products को optional रूप से named groups में व्यवस्थित करें (जैसे, “Monthly Plans”, “Annual Plans”)।
Ungrouped products: बिना group वाले products collection level पर दिखाई देते हैं।
Ordering: Display order निर्धारित करने के लिए drag and drop करें।

प्रत्येक product केवल एक collection से संबंधित हो सकता है। यदि कोई product पहले से किसी अन्य collection में है, तो पहले उसे हटाएँ।

Configure ordering and visibility

Collection के भीतर products का display order और visibility नियंत्रित करें।Configuration options:

Product status: Collection के भीतर अलग-अलग products को enable या disable करें।
Display order: Checkout में products के दिखाई देने का क्रम निर्धारित करने के लिए drag and drop करें।

Collection का पहला product checkout पर अपने-आप pre-selected होता है। Default रूप से चुने गए product को बदलने के लिए products का क्रम बदलें।

Collection Checkout

Collections एक unified checkout experience सक्षम करते हैं, जहाँ customers सभी उपलब्ध products को एक ही स्थान पर देख और चुन सकते हैं।

Checkout Types

Type	Description	Use Case
Collection Checkout	Collection के भीतर सभी active products प्रदर्शित करता है	Subscription plan चयन, tiered pricing
Single Product Checkout	केवल एक specific product प्रदर्शित करता है	Direct purchase, promotional links

Collection Checkout Experience

Collection checkout का उपयोग करते समय:

Collection के सभी active products प्रदर्शित किए जाते हैं।
Collection order में पहला product अपने-आप pre-selected होता है।
प्रत्येक product अपना name, description और pricing दिखाता है।
Customer खरीदने के लिए एक product चुनता है।
Checkout चुने गए product की pricing और billing settings के साथ आगे बढ़ता है।

Screenshot of the Product Collection checkout page showing multiple products displayed

Collection checkout subscription businesses के लिए आदर्श है, जहाँ customers खरीदने से पहले plans की side-by-side तुलना करते हैं।

API Integration

किसी collection के लिए checkout session बनाएँ:

const session = await client.checkoutSessions.create({
  product_collection_id: 'pdc_abc123',
  product_cart: [], // Required: pass an empty array for collection checkout
  return_url: 'https://yoursite.com/return'
});

window.location.href = session.checkout_url;

product_collection_id का उपयोग करते समय session creation पर discount codes pre-apply नहीं किए जा सकते। यदि enabled हों, तो customers checkout के दौरान codes दर्ज कर सकते हैं।

Customer Portal Integration

Customers Customer Portal से सीधे उसी collection के products के बीच upgrade या downgrade कर सकते हैं।

क्या आपके पास पहले से subscription products हैं? Customer Portal में upgrade/downgrade flows enable करने के लिए उन्हें Product Collection में जोड़ें। अपने products को दोबारा बनाने की आवश्यकता नहीं है।

Plan Management Actions

Action	Description	Merchant Control
View Current Plan	वर्तमान product name, price और renewal date प्रदर्शित करें।	हमेशा उपलब्ध।
Upgrade Plan	उसी collection में higher-tier product पर जाएँ।	Configurable (default: disabled)।
Downgrade Plan	उसी collection में lower-tier product पर जाएँ।	Configurable (default: disabled)।
Cancel	Subscription को पूरी तरह cancel करें।	हमेशा उपलब्ध।

Upgrade/Downgrade Rules

Upgrades और downgrades केवल उसी collection के products के बीच उपलब्ध हैं।
Customer Portal plan changes के लिए proration, Settings → Subscriptions में default upgrade और downgrade behavior का पालन करता है, और प्रत्येक collection इन defaults को override कर सकता है। Change Plan API के माध्यम से किए गए plan changes request के साथ भेजे गए proration_billing_mode का उपयोग करते हैं।
प्रत्येक upgrade, downgrade या cancellation पर business को email notifications भेजी जाती हैं।

Customers अपनी current collection के बाहर के products पर switch नहीं कर सकते। अलग-अलग product lines के लिए अलग collections बनाएँ।

Subscription Settings

अपने dashboard में Settings → Subscriptions से पूरे business में subscriptions और plan changes के काम करने का तरीका configure करें।

Available Settings

Setting	Description	Default
Allow Multiple Subscriptions	Customers एक ही समय में एक से अधिक active subscriptions रख सकते हैं।	Enabled
Allow Subscription Updates	Customers Customer Portal के माध्यम से किसी भी समय अपनी existing subscriptions को upgrade या downgrade कर सकते हैं।	Disabled
Allow Immediate Cancellation	Customers अपनी subscription समाप्त कर सकते हैं और तुरंत access खो देते हैं।	Enabled
Allow Cancellation at Next Billing Date	Customers पहले से paid period के अंत में cancel कर सकते हैं।	Enabled
Allow Subscription Pause	Customers Customer Portal से अपनी subscriptions को pause और resume कर सकते हैं।	Disabled
Bill Usage at Pause	Paused usage-based subscription को pause किए जाने के समय उसके owed usage के लिए invoice किया जाता है, बजाय usage को अगली regular invoice तक ले जाने के।	Enabled
Prevent Trial Misuse	जिन customers ने पहले ही trial redeem कर लिया है, उन्हें नए trial के बजाय paid, no-trial purchase पर भेजा जाता है।	Disabled
Payment Method Reminder	Billing शुरू होने से कितने दिन पहले Card-Optional at Zero Price subscription के customer को payment method जोड़ने के लिए email भेजी जाए (1 से 30 दिन)।	3 days

Customer Portal के माध्यम से plan changes default रूप से disabled होते हैं। Customers को उसी collection में products के बीच upgrade या downgrade करने देने के लिए Settings → Subscriptions में “Allow Subscription Updates” enable करें।

Cancellation की दोनों settings स्वतंत्र हैं, इसलिए आप customers को पहले से paid period पूरा करने दे सकते हैं और instant cancellation को केवल अपने लिए रख सकते हैं, या इसका उल्टा कर सकते हैं। किसी एक को बंद करने पर Customer Portal में वह option छिप जाता है और Customer Portal API के माध्यम से उसके requests अस्वीकार हो जाते हैं। आपके अपने merchant-side cancellations प्रभावित नहीं होते। Cancelling a Subscription देखें।

“Allow Subscription Pause” केवल Customer Portal को नियंत्रित करता है — setting चाहे जो हो, आप dashboard या API से pause और resume कर सकते हैं। “Bill Usage at Pause” केवल usage-based subscriptions पर लागू होता है और प्रत्येक billing cycle के लिए record किया जाता है, इसलिए इसे cycle के बीच बदलने से चल रहे cycle का settlement नहीं बदलता। Pausing and Resuming Subscriptions देखें।

Trial redemptions का मिलान और record कैसे किया जाता है, इसके विवरण के लिए Preventing Trial Misuse देखें।

“Payment Method Reminder” केवल उन subscriptions के लिए महत्वपूर्ण है जिनमें Card-Optional at Zero Price enabled है — इसका उन subscriptions पर कोई प्रभाव नहीं पड़ता जिनमें पहले से card आवश्यक है। पूरी sequence के लिए What Happens Without a Card देखें, जिसमें reminder को अनदेखा करने पर होने वाली स्थिति भी शामिल है।

Subscription Plan Changes

Proration modes और plan change behavior के बारे में अधिक जानें।

Collections Manage करना

Dashboard के माध्यम से या API द्वारा programmatically collections manage करें।

Dashboard Operations

Create: Products और groups के साथ नई collections set up करें।
Update: Name, description, image और product organization में बदलाव करें।
Reorder: Product display order बदलने के लिए drag and drop करें।
Enable/Disable products: नियंत्रित करें कि कौन से products checkout में दिखाई दें।
Archive: Collection को स्थायी रूप से delete किए बिना छिपाएँ (बाद में unarchive किया जा सकता है)।

Screenshot of the Product Collection dashboard showing the collection management operations

API Management

Nested groups और products के management सहित, product collections को programmatically create, update, retrieve, archive और organize करने के लिए निम्न endpoints का उपयोग करें।

Listing Product Collections

अपने account से संबद्ध सभी product collections को GET request के माध्यम से /product-collections endpoint से fetch करें। Pagination, brand के आधार पर filtering और archived collections को शामिल करना supported है।

List Product Collections API

List Product Collections API documentation में detailed request और response structure देखें।

Creating a Product Collection

Name, description और brand जैसी details के साथ POST request को /product-collections endpoint पर भेजकर नई product collection बनाएँ।

Create Product Collection API

Create Product Collection API documentation में detailed request और response structure देखें।

Retrieving a Product Collection

किसी specific product collection के बारे में detailed information — जिसमें उसके groups और product items शामिल हैं — GET request के माध्यम से /product-collections/{id} endpoint से प्राप्त करें।

Get Product Collection API

Get Product Collection API documentation में detailed request और response structure देखें।

Updating a Product Collection

PATCH request को /product-collections/{id} endpoint पर भेजकर product collection की details (name, description, brand आदि) modify करें।

Update Product Collection API

Update Product Collection API documentation में detailed request और response structure देखें।

Uploading Collection Images

Pre-signed URL के माध्यम से image upload करके उसे collection से associate करें। /product-collections/{id}/images endpoint से upload URL माँगें, फिर 60 seconds के भीतर returned URL पर image को PUT करें।

Pre-signed URL 60 seconds में expire हो जाता है, इसलिए image को इसी timeframe में upload करना आवश्यक है।

Update Collection Images API

Update Collection Images API documentation में detailed request और response structure देखें।

Archiving a Product Collection

DELETE request को /product-collections/{id} endpoint पर भेजकर collection archive करें। इससे collection नए use से छिप जाती है, लेकिन स्थायी रूप से remove नहीं होती।

Archive Product Collection API

Archive Product Collection API documentation में detailed request और response structure देखें।

Unarchiving a Product Collection

POST request को /product-collections/{id}/unarchive endpoint पर भेजकर archived collection restore करें।

Unarchive Product Collection API

Unarchive Product Collection API documentation में detailed request और response structure देखें।

Managing Groups within a Collection

Groups आपको collection के भीतर products व्यवस्थित करने देते हैं (उदाहरण के लिए, “Monthly Plans” और “Annual Plans”)। Collection के भीतर groups जोड़ने, update करने या remove करने के लिए groups endpoints का उपयोग करें।

Create a group: POST /product-collections/{id}/groups
Update a group: PATCH /product-collections/{id}/groups/{group_id}
Delete a group: DELETE /product-collections/{id}/groups/{group_id}

Create Group

Product collection में नया group जोड़ें।

Update Group

Group का name या attributes modify करें।

Delete Group

Collection से group remove करें।

Managing Products within a Group

Group के भीतर individual product items manage करें — नए products जोड़ें, existing items (जैसे display order) update करें या उन्हें पूरी तरह remove करें।

Add products to a group: POST /product-collections/{id}/groups/{group_id}/items
Update a group item: PATCH /product-collections/{id}/groups/{group_id}/items/{item_id}
Delete a group item: DELETE /product-collections/{id}/groups/{group_id}/items/{item_id}

Add Products to Group

Collection के भीतर किसी group में एक या अधिक products जोड़ें।

Update Group Item

Group के भीतर किसी product item को update करें।

Delete Group Item

Group से product item remove करें।

Best Practices

Group logically: Products को billing interval (monthly/annual) या feature tier (starter/pro/enterprise) के आधार पर व्यवस्थित करें।
Order strategically: सबसे लोकप्रिय या recommended plan को पहले रखें, क्योंकि checkout पर वही pre-selected होगा।
Use clear naming: Product names को value differences स्पष्ट रूप से communicate करना चाहिए।
Enable both directions: Customers को flexibility देने के लिए upgrades और downgrades दोनों की अनुमति दें।
Consider proration: ऐसा proration mode चुनें जो आपके business model के अनुरूप हो।
Test thoroughly: Live होने से पहले test mode में checkout और plan change flows verify करें।

Products

Collections में जोड़ने के लिए one-time, subscription या usage-based products बनाएं।

Checkout

Collection products को एकीकृत checkout experience में दिखाएं।

Customer Portal

ग्राहकों को उसी collection के भीतर upgrade या downgrade करने दें।

Subscriptions

proration और plan changes के साथ recurring plans प्रबंधित करें।

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

प्रमुख हाइलाइट्स

Product Collection बनाना