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

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 में अपग्रेड/डाउनग्रेड फ्लो सक्षम हो सके। अपने उत्पादों को फिर से बनाने की आवश्यकता नहीं है।

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

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

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

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

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

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

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

अपने व्यापार में सब्सक्रिप्शन और प्लान परिवर्तन कैसे काम करते हैं इसे कॉन्फ़िगर करें 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
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 देखें।

Trial redemptions का मिलान और रिकॉर्ड किस तरह किया जाता है, इसकी जानकारी के लिए 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 के प्रबंधन पर पूर्ण नियंत्रण प्रदान करता है।

Dashboard Operations

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

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

API Management

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

Listing Product Collections

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

List Product Collections API

List Product Collections API documentation में विस्तृत 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 में विस्तृत request और response structure देखें।

Retrieving a Product Collection

किसी विशिष्ट product collection के बारे में विस्तृत जानकारी — जिसमें उसके groups और product items शामिल हैं — प्राप्त करने के लिए GET request को /product-collections/{id} endpoint पर भेजें।

Get Product Collection API

Get Product Collection API documentation में विस्तृत 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 में विस्तृत request और response structure देखें।

Uploading Collection Images

pre-signed URL के माध्यम से image upload करके उसे collection से संबद्ध करें। /product-collections/{id}/images endpoint से upload URL का अनुरोध करें, फिर image को 60 seconds के भीतर लौटाए गए URL पर PUT करें।

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

Update Collection Images API

Update Collection Images API documentation में विस्तृत request और response structure देखें।

Archiving a Product Collection

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

Archive Product Collection API

Archive Product Collection API documentation में विस्तृत 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 में विस्तृत 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 में बदलाव करें।

Delete Group

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

Managing Products within a Group

किसी group के भीतर मौजूद individual product items को manage करें — नए products जोड़ें, मौजूदा 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 करें: 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 को unified plan selection experience देने के लिए तैयार हैं।

Products

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

Checkout

collection products को unified checkout experience में display करें।

Customer Portal

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

Subscriptions

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

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

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

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