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

Product Collections आपको संबंधित उत्पादों (जैसे Starter, Pro, Enterprise योजनाएँ) को एक ही छत के नीचे समूहबद्ध करने देते हैं। सभी विकल्पों को एक ही चेकआउट में दिखाएँ, अपग्रेड/डाउनग्रेड पथ निर्धारित करें, और ग्राहकों को Customer Portal से सीधे योजनाएँ बदलने की लचीलापन दें।

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

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

संग्रह आधारित संरचना: संबंधित उत्पादों (योजनाएँ, स्तर, मूल्य विकल्प) को संगठित प्रबंधन के लिए एक ही संग्रह के अंतर्गत समूहबद्ध करें।
एक संग्रह, कई उत्पाद: स्टार्टर्स, प्रो, लाइफटाइम आदि जैसे कई उत्पाद शामिल करें, प्रत्येक के पास अपनी मूल्य निर्धारण मॉडल हो।
गतिशील चेकआउट अनुभव: एक चेकआउट व्यू में एक संग्रह के सभी उत्पादों को दिखाएँ, जिससे ग्राहकों को उनकी पसंदीदा योजना चुनने दिया जा सके।
व्यापारी स्तर का नियंत्रण: प्रत्येक संग्रह के भीतर उत्पादों को सक्षम, अक्षम और पुनर्व्यवस्थित करें। चेकआउट पर पहला उत्पाद स्वचालित रूप से पूर्व-निर्धारित होता है।
जीवन चक्र जागरूकता: ग्राहकों को ग्राहक पोर्टल के माध्यम से एक ही संग्रह में उत्पादों के बीच उन्नयन या कम करने की अनुमति दें।

एक उत्पाद संग्रह बनाएँ

उत्पाद संग्रह को डैशबोर्ड से या API के माध्यम से बनाया और प्रबंधित किया जाता है। प्रत्येक संग्रह संबंधित उत्पादों के लिए एक कंटेनर के रूप में कार्य करता है।

Create the collection

कलेक्शन को एक नाम और वैकल्पिक विवरण के साथ परिभाषित करें। चेकआउट में कलेक्शन का दृश्य प्रतिनिधित्व करने के लिए एक छवि अपलोड करें।

डैशबोर्ड में प्रोडक्ट कलेक्शन निर्माण फॉर्म का स्क्रीनशॉट जिसमें नाम, विवरण, और छवि अपलोड के लिए फ़ील्ड दिखा रहा है

संग्रह फ़ील्ड:

नाम (आवश्यक): संग्रह के लिए प्रदर्शित नाम (जैसे, “SaaS योजनाएँ”, “लाइसेंस स्तर”)
विवरण (वैकल्पिक): चेकआउट में दिखाया जाने वाला संक्षिप्त विवरण
छवि (वैकल्पिक): संग्रह के लिए दृश्य ब्रांडिंग

Add products to the collection

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

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

उत्पाद संगठन:

समूह: वैकल्पिक रूप से उत्पादों को नामित समूहों में व्यवस्थित करें (जैसे, “मासिक योजनाएँ”, “वार्षिक योजनाएँ”)
असंगठित उत्पाद: बिना समूह वाले उत्पाद संग्रह स्तर पर दिखाई देते हैं
क्रमबद्ध करना: प्रदर्शित क्रम निर्धारित करने के लिए खींचें और छोड़ें

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

Configure ordering and visibility

कलेक्शन के भीतर उत्पादों के प्रदर्शन क्रम और दृश्यता को नियंत्रित करें।कॉन्फ़िगरेशन विकल्प:

उत्पाद स्थिति: संग्रह के भीतर व्यक्तिगत उत्पादों को सक्षम या अक्षम करें
प्रदर्शन क्रम: चेकआउट में उत्पादों के अनुक्रम को सेट करने के लिए खींचें और छोड़ें

कलेक्शन में पहला उत्पाद चेकआउट में स्वचालित रूप से डिफ़ॉल्ट के रूप में पहले से चुना जाता है। डिफ़ॉल्ट चुने जाने वाले उत्पाद को बदलने के लिए उत्पादों को पुन:क्रमित करें।

संग्रह चेकआउट

संग्रह एक एकीकृत चेकआउट अनुभव को सक्षम बनाते हैं जहाँ ग्राहक एक ही स्थान पर सभी उपलब्ध उत्पादों को देख और चुन सकते हैं।

चेकआउट प्रकार

प्रकार	विवरण	उपयोग का मामला
संग्रह चेकआउट	एक संग्रह के भीतर सभी सक्रिय उत्पादों को प्रदर्शित करता है	सदस्यता योजना चयन, स्तरीय मूल्य निर्धारण
एकल उत्पाद चेकआउट	केवल एक विशिष्ट उत्पाद प्रदर्शित करता है	सीधे खरीद, प्रचारात्मक लिंक

संग्रह चेकआउट अनुभव

जब संग्रह चेकआउट का उपयोग किया जाता है:

सभी सक्रिय उत्पाद प्रदर्शित: ग्राहक संग्रह में हर सक्षम उत्पाद देखेंगे
पहला उत्पाद पूर्व-निर्धारित: संग्रहक्रम में पहला उत्पाद स्वचालित रूप से चुना जाता है
उत्पाद विवरण दिखाया गया: प्रत्येक उत्पाद का नाम, विवरण और मूल्य दिखाया जाता है
एकल चयन: ग्राहक एक उत्पाद को खरीदने के लिए चुनता है
मानक प्रवाह जारी रहता है: चयन के बाद, चेकआउट चुने गए उत्पाद की मूल्य निर्धारण और बिलिंग सेटिंग्स के साथ आगे बढ़ता है

कलेक्शन चेकआउट उन सब्सक्रिप्शन व्यवसायों के लिए आदर्श है जहाँ आप चाहते हैं कि ग्राहक खरीदारी से पहले योजनाओं की तुलना एक दूसरे के साथ करें।

API एकीकरण

एक संग्रह के लिए चेकआउट सत्र बनाएँ:

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'
});

// Redirect customer to the checkout
window.location.href = session.checkout_url;

product_collection_id का उपयोग करते समय, डिस्काउंट कोड सेशन निर्माण के समय लागू नहीं किए जा सकते। यदि सक्षम किया गया हो, तो ग्राहक चेकआउट के दौरान डिस्काउंट कोड दर्ज कर सकते हैं।

ग्राहक पोर्टल एकीकरण

ग्राहक ग्राहक पोर्टल से सीधे एक ही संग्रह के भीतर उत्पादों के बीच उन्नयन या कम कर सकते हैं।

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

योजना प्रबंधन क्रियाएँ

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

प्रोडक्ट कलेक्शन ग्राहक पोर्टल प्लान परिवर्तन इंटरफेस का स्क्रीनशॉट जिसमें प्लान प्रबंधन क्रियाएं दिखाई दे रही हैं

अपग्रेड/डाउनग्रेड नियम

अपग्रेड और डाउनग्रेड केवल एक ही कलेक्शन के भीतर के उत्पादों के बीच उपलब्ध होते हैं
प्रोरैशन आपके सब्सक्रिप्शन सेटिंग्स के आधार पर लागू किया जाता है
प्रत्येक अपग्रेड, डाउनग्रेड, या रद्दीकरण पर व्यवसाय को ईमेल सूचनाएँ भेजी जाती हैं

ग्राहक अपने वर्तमान कलेक्शन के बाहर के उत्पादों में परिवर्तन नहीं कर सकते। अलग-अलग उत्पाद पंक्तियों के लिए अलग कलेक्शन बनाएं।

सब्सक्रिप्शन सेटिंग्स

अपने व्यापार में सब्सक्रिप्शन और प्लान परिवर्तन कैसे काम करते हैं इसे कॉन्फ़िगर करें Settings → Subscriptions में जाकर।

उपलब्ध सेटिंग्स

Setting	Description	Default
एक से अधिक Subscriptions की अनुमति दें	Customers एक ही समय में एक से अधिक active subscription रख सकते हैं	Enabled
Subscription Updates की अनुमति दें	Customers Customer Portal के माध्यम से किसी भी समय अपनी मौजूदा subscriptions को upgrade या downgrade कर सकते हैं	Disabled
Subscription Cancellation की अनुमति दें	Customers Customer Portal से अपनी subscriptions cancel कर सकते हैं	Enabled
Subscription Pause की अनुमति दें	Customers Customer Portal से अपनी subscriptions को pause और resume कर सकते हैं	Disabled
Pause पर Usage Bill करें	paused usage-based subscription को pause किए जाने के समय उसके बकाया usage के लिए invoice किया जाता है, बजाय usage को अगले नियमित invoice में ले जाने के	Enabled
Trial Misuse रोकें	जिन Customers ने पहले ही trial redeem किया है, उन्हें नया trial देने के बजाय paid, no-trial purchase में बदल दिया जाता है	Disabled

Customer Portal के माध्यम से प्लान परिवर्तन डिफ़ॉल्ट रूप से अक्षम होते हैं। ग्राहकों को उसी कलेक्शन में उत्पादों के बीच अपग्रेड या डाउनग्रेड करने की अनुमति देने के लिए “Allow Subscription Updates” को सक्षम करें Settings → Subscriptions में।

“Allow Subscription Cancellation” को बंद करने से customers के लिए self-service cancellation छिप जाता है और Customer Portal API के माध्यम से किए गए cancellation 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 किया जाता है, इसलिए mid-cycle इसे बदलने से वर्तमान cycle के settlement का तरीका नहीं बदलता। Pausing and Resuming Subscriptions देखें।

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

Subscription Plan Changes

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

Collections प्रबंधित करना

Product Collections को Dodo Payments dashboard के माध्यम से या API का उपयोग करके programmatically प्रबंधित किया जा सकता है। API collection creation, updates, image uploads, archiving और nested groups तथा products को manage करने पर पूरा control प्रदान करता है।

Dashboard Operations

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

Product Collection dashboard का screenshot, जिसमें collection management operations दिखाई गई हैं

API Management

निम्न endpoints आपको product collections को programmatically create, update, retrieve, archive और organize करने की अनुमति देते हैं — इसमें nested groups और उनके भीतर के products को manage करना भी शामिल है।

Listing Product Collections

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

List Product Collections API

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

Creating a Product Collection

name, description और brand जैसे विवरणों के साथ 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 के विवरण (name, description, brand आदि) में बदलाव करें।

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 को इसी समय-सीमा के भीतर 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 नए उपयोग से छिप जाती है, लेकिन permanently 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 को add, update या remove करने के लिए groups endpoints का उपयोग करें।

Group बनाएँ: POST /product-collections/{id}/groups
Group अपडेट करें: PATCH /product-collections/{id}/groups/{group_id}
Group डिलीट करें: DELETE /product-collections/{id}/groups/{group_id}

Create Group

किसी product collection में नया group add करें।

Update Group

किसी group के name या attributes में बदलाव करें।

Delete Group

किसी collection से group remove करें।

Managing Products within a Group

किसी group के भीतर individual product items को manage करें — नए products add करें, मौजूदा items (जैसे display order) को update करें या उन्हें पूरी तरह remove करें।

Group में products add करें: POST /product-collections/{id}/groups/{group_id}/items
Group item अपडेट करें: PATCH /product-collections/{id}/groups/{group_id}/items/{item_id}
Group item डिलीट करें: DELETE /product-collections/{id}/groups/{group_id}/items/{item_id}

Add Products to Group

किसी collection के भीतर group में एक या अधिक products add करें।

Update Group Item

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

Delete Group Item

किसी group से product item remove करें।

Best Practices

तार्किक रूप से Group करें: products को billing interval (monthly/annual) या feature tier (starter/pro/enterprise) के आधार पर व्यवस्थित करें
रणनीतिक रूप से Order करें: अपने सबसे लोकप्रिय या recommended plan को पहले रखें, क्योंकि checkout पर यह pre-selected होगा
स्पष्ट Naming का उपयोग करें: Product names को value differences स्पष्ट रूप से communicate करना चाहिए
दोनों दिशाएँ Enable करें: Customers को flexibility देने के लिए upgrades और downgrades दोनों की अनुमति दें
Proration पर विचार करें: ऐसा proration mode चुनें जो आपके business model के अनुरूप हो
पूरी तरह Test करें: live जाने से पहले test mode में checkout और plan change flows को verify करें

अब आप product collections बनाने और Customers को एकीकृत plan selection experience देने के लिए तैयार हैं।

Products

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

Checkout

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

Customer Portal

Customers को उसी collection में upgrade या downgrade करने दें।

Subscriptions

Proration और plan changes के साथ recurring plans manage करें।

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

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

एक उत्पाद संग्रह बनाएँ