> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.
# उत्पाद संग्रह
> संबंधित उत्पादों को एकत्र करें ताकि एकीकृत चेकआउट अनुभव, योजना चयन, और ग्राहक पोर्टल के भीतर आसानी से उन्नयन/कम करने के मार्ग निर्धारित किया जा सके।
Product Collections आपको संबंधित उत्पादों (जैसे Starter, Pro, Enterprise योजनाएँ) को एक ही छत के नीचे समूहबद्ध करने देते हैं। सभी विकल्पों को एक ही चेकआउट में दिखाएँ, अपग्रेड/डाउनग्रेड पथ निर्धारित करें, और ग्राहकों को Customer Portal से सीधे योजनाएँ बदलने की लचीलापन दें।
## प्रमुख हाइलाइट्स
* **संग्रह आधारित संरचना**: संबंधित उत्पादों (योजनाएँ, स्तर, मूल्य विकल्प) को संगठित प्रबंधन के लिए एक ही संग्रह के अंतर्गत समूहबद्ध करें।
* **एक संग्रह, कई उत्पाद**: स्टार्टर्स, प्रो, लाइफटाइम आदि जैसे कई उत्पाद शामिल करें, प्रत्येक के पास अपनी मूल्य निर्धारण मॉडल हो।
* **गतिशील चेकआउट अनुभव**: एक चेकआउट व्यू में एक संग्रह के सभी उत्पादों को दिखाएँ, जिससे ग्राहकों को उनकी पसंदीदा योजना चुनने दिया जा सके।
* **व्यापारी स्तर का नियंत्रण**: प्रत्येक संग्रह के भीतर उत्पादों को सक्षम, अक्षम और पुनर्व्यवस्थित करें। चेकआउट पर पहला उत्पाद स्वचालित रूप से पूर्व-निर्धारित होता है।
* **जीवन चक्र जागरूकता**: ग्राहकों को ग्राहक पोर्टल के माध्यम से एक ही संग्रह में उत्पादों के बीच उन्नयन या कम करने की अनुमति दें।
## एक उत्पाद संग्रह बनाएँ
उत्पाद संग्रह को डैशबोर्ड से या API के माध्यम से बनाया और प्रबंधित किया जाता है। प्रत्येक संग्रह संबंधित उत्पादों के लिए एक कंटेनर के रूप में कार्य करता है।
कलेक्शन को एक नाम और वैकल्पिक विवरण के साथ परिभाषित करें। चेकआउट में कलेक्शन का दृश्य प्रतिनिधित्व करने के लिए एक छवि अपलोड करें।
**संग्रह फ़ील्ड:**
* **नाम** (आवश्यक): संग्रह के लिए प्रदर्शित नाम (जैसे, "SaaS योजनाएँ", "लाइसेंस स्तर")
* **विवरण** (वैकल्पिक): चेकआउट में दिखाया जाने वाला संक्षिप्त विवरण
* **छवि** (वैकल्पिक): संग्रह के लिए दृश्य ब्रांडिंग
अपने कलेक्शन में मौजूदा उत्पाद जोड़ें। बेहतर संरचना के लिए उत्पादों को समूहों में व्यवस्थित किया जा सकता है।
**उत्पाद संगठन:**
* **समूह**: वैकल्पिक रूप से उत्पादों को नामित समूहों में व्यवस्थित करें (जैसे, "मासिक योजनाएँ", "वार्षिक योजनाएँ")
* **असंगठित उत्पाद**: बिना समूह वाले उत्पाद संग्रह स्तर पर दिखाई देते हैं
* **क्रमबद्ध करना**: प्रदर्शित क्रम निर्धारित करने के लिए खींचें और छोड़ें
प्रत्येक उत्पाद केवल एक ही कलेक्शन से संबंधित हो सकता है। यदि कोई उत्पाद पहले से किसी अन्य कलेक्शन में है, तो आपको पहले इसे हटाना होगा।
कलेक्शन के भीतर उत्पादों के प्रदर्शन क्रम और दृश्यता को नियंत्रित करें।
**कॉन्फ़िगरेशन विकल्प:**
* **उत्पाद स्थिति**: संग्रह के भीतर व्यक्तिगत उत्पादों को सक्षम या अक्षम करें
* **प्रदर्शन क्रम**: चेकआउट में उत्पादों के अनुक्रम को सेट करने के लिए खींचें और छोड़ें
कलेक्शन में पहला उत्पाद चेकआउट में स्वचालित रूप से डिफ़ॉल्ट के रूप में पहले से चुना जाता है। डिफ़ॉल्ट चुने जाने वाले उत्पाद को बदलने के लिए उत्पादों को पुन:क्रमित करें।
## संग्रह चेकआउट
संग्रह एक एकीकृत चेकआउट अनुभव को सक्षम बनाते हैं जहाँ ग्राहक एक ही स्थान पर सभी उपलब्ध उत्पादों को देख और चुन सकते हैं।
### चेकआउट प्रकार
| प्रकार | विवरण | उपयोग का मामला |
| --------------------- | ---------------------------------------------------------- | ---------------------------------------- |
| **संग्रह चेकआउट** | एक संग्रह के भीतर सभी सक्रिय उत्पादों को प्रदर्शित करता है | सदस्यता योजना चयन, स्तरीय मूल्य निर्धारण |
| **एकल उत्पाद चेकआउट** | केवल एक विशिष्ट उत्पाद प्रदर्शित करता है | सीधे खरीद, प्रचारात्मक लिंक |
### संग्रह चेकआउट अनुभव
जब संग्रह चेकआउट का उपयोग किया जाता है:
1. **सभी सक्रिय उत्पाद प्रदर्शित**: ग्राहक संग्रह में हर सक्षम उत्पाद देखेंगे
2. **पहला उत्पाद पूर्व-निर्धारित**: संग्रहक्रम में पहला उत्पाद स्वचालित रूप से चुना जाता है
3. **उत्पाद विवरण दिखाया गया**: प्रत्येक उत्पाद का नाम, विवरण और मूल्य दिखाया जाता है
4. **एकल चयन**: ग्राहक एक उत्पाद को खरीदने के लिए चुनता है
5. **मानक प्रवाह जारी रहता है**: चयन के बाद, चेकआउट चुने गए उत्पाद की मूल्य निर्धारण और बिलिंग सेटिंग्स के साथ आगे बढ़ता है
कलेक्शन चेकआउट उन सब्सक्रिप्शन व्यवसायों के लिए आदर्श है जहाँ आप चाहते हैं कि ग्राहक खरीदारी से पहले योजनाओं की तुलना एक दूसरे के साथ करें।
### API एकीकरण
एक संग्रह के लिए चेकआउट सत्र बनाएँ:
```typescript theme={null}
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 |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------ | -------- |
| **Allow Multiple Subscriptions** | ग्राहक एक ही समय में एक से अधिक सक्रिय सब्सक्रिप्शन रख सकते हैं | Enabled |
| **Allow Subscription Updates** | ग्राहक Customer Portal के माध्यम से किसी भी समय अपने मौजूदा सब्सक्रिप्शन को अपग्रेड या डाउनग्रेड कर सकते हैं | Disabled |
Customer Portal के माध्यम से प्लान परिवर्तन डिफ़ॉल्ट रूप से अक्षम होते हैं। ग्राहकों को उसी कलेक्शन में उत्पादों के बीच अपग्रेड या डाउनग्रेड करने की अनुमति देने के लिए "Allow Subscription Updates" को सक्षम करें **Settings → Subscriptions** में।
प्रोरैशन मोड और योजना परिवर्तन व्यवहार के बारे में और जानें।
## कलेक्शन प्रबंधन
प्रोडक्ट कलेक्शंस को या तो Dodo Payments डैशबोर्ड के माध्यम से या प्रोग्रामेटिक रूप से API के माध्यम से मैनेज किया जा सकता है। API संग्रह निर्माण, अपडेट, इमेज अपलोड्स, आर्काइविंग और नेस्टेड ग्रुप्स और प्रोडक्ट्स को मैनेज करने पर पूर्ण नियंत्रण प्रदान करता है।
### डैशबोर्ड ऑपरेशन्स
* **Create**: प्रोडक्ट्स और ग्रुप्स के साथ नए कलेक्शंस सेट अप करें
* **Update**: नाम, विवरण, इमेज, और प्रोडक्ट संगठन में संशोधन करें
* **Reorder**: प्रोडक्ट डिस्प्ले क्रम बदलने के लिए ड्रैग और ड्रॉप करें
* **Enable/Disable products**: नियंत्रित करें कि कौन से प्रोडक्ट चेकआउट में दिखाई देंगे
* **Archive**: किसी कलेक्शन को स्थायी रूप से हटाए बिना छिपाएं (बाद में इसे अनार्काइव किया जा सकता है)
### API प्रबंधन
निम्नलिखित एन्डपॉइंट आपको प्रोग्रामेटिक रूप से प्रोडक्ट कलेक्शंस को बनाने, अपडेट करने, पुनः प्राप्त करने, आर्काइव करने और संगठन करने की सुविधा प्रदान करते हैं — जिसमें नेस्टेड ग्रुप्स और उनके अंदर के प्रोडक्ट्स का प्रबंधन करना शामिल है।
अपने खाते से जुड़े सभी प्रोडक्ट कलेक्शंस को प्राप्त करें एक `GET` अनुरोध के माध्यम से `/product-collections` एन्डपॉइंट पर। पेजिनेशन का समर्थन करता है, ब्रांड के अनुसार फ़िल्टरिंग, और आर्काइव्ड कलेक्शंस शामिल करना।
लिस्ट प्रोडक्ट कलेक्शंस API डॉक्यूमेंटेशन में विस्तृत अनुरोध और प्रतिक्रिया संरचना देखें।
नए प्रोडक्ट कलेक्शन को बनाने के लिए `POST` अनुरोध को `/product-collections` एन्डपॉइंट पर भेजें और इसमें जैसे विवरण जैसे नाम, विवरण, और ब्रांड शामिल करें।
क्रिएट प्रोडक्ट कलेक्शन API डॉक्यूमेंटेशन में विस्तृत अनुरोध और प्रतिक्रिया संरचना देखें।
किसी विशेष प्रोडक्ट कलेक्शन के बारे में विस्तृत जानकारी प्राप्त करें - इसमें उसके ग्रुप्स और प्रोडक्ट आइटम्स शामिल हैं - इसका उपयोग करके `GET` अनुरोध को `/product-collections/{id}` एन्डपॉइंट पर भेजें।
गेट प्रोडक्ट कलेक्शन API डॉक्यूमेंटेशन में विस्तृत अनुरोध और प्रतिक्रिया संरचना देखें।
किसी प्रोडक्ट कलेक्शन के विवरण (नाम, विवरण, ब्रांड, आदि) को अपडेट करें `PATCH` अनुरोध को `/product-collections/{id}` एन्डपॉइंट पर भेजकर।
अपडेट प्रोडक्ट कलेक्शन API डॉक्यूमेंटेशन में विस्तृत अनुरोध और प्रतिक्रिया संरचना देखें।
किसी कलेक्शन के साथ एक इमेज को संबद्ध करें और इसे एक प्री-साइन URL के माध्यम से अपलोड करें। अपलोड URL के लिए `/product-collections/{id}/images` एन्डपॉइंट से अनुरोध करें, फिर वापस प्राप्त URL पर 60 सेकंड के भीतर `PUT` द्वारा इमेज को अपलोड करें।
प्री-साइन URL 60 सेकंड में समाप्त हो जाता है, इसलिए इमेज को इस समयसीमा के भीतर अपलोड किया जाना चाहिए।
अपडेट कलेक्शन इमेजेज़ API डॉक्यूमेंटेशन में विस्तृत अनुरोध और प्रतिक्रिया संरचना देखें।
किसी कलेक्शन को आर्काइव करें `DELETE` अनुरोध के माध्यम से `/product-collections/{id}` एन्डपॉइंट पर। यह संग्रह को नए उपयोग से छिपा देता है लेकिन इसे स्थायी रूप से नहीं हटाता।
आर्काइव प्रोडक्ट कलेक्शन API डॉक्यूमेंटेशन में विस्तृत अनुरोध और प्रतिक्रिया संरचना देखें।
किसी आर्काइव किए गए कलेक्शन को पुनर्स्थापित करें `POST` अनुरोध को `/product-collections/{id}/unarchive` एन्डपॉइंट पर भेजकर।
अनार्काइव प्रोडक्ट कलेक्शन API डॉक्यूमेंटेशन में विस्तृत अनुरोध और प्रतिक्रिया संरचना देखें।
ग्रुप्स आपको कलेक्शन के अंदर प्रोडक्ट्स को संगठित करने की अनुमति देते हैं (उदाहरण के लिए, "मासिक योजनाएं" बनाम "वार्षिक योजनाएं")। किसी कलेक्शन के अंदर ग्रुप्स को जोड़ने, अपडेट करने, या हटाने के लिए ग्रुप्स एन्डपॉइंट का उपयोग करें।
* **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}`
किसी प्रोडक्ट कलेक्शन में एक नया ग्रुप जोड़ें।
किसी ग्रुप के नाम या विशेषताओं को संशोधित करें।
किसी कलेक्शन से किसी ग्रुप को हटाएं।
किसी ग्रुप के अंदर व्यक्तिगत प्रोडक्ट्स आइटम्स का प्रबंधन करें — नए प्रोडक्ट्स जोड़ें, मौजूदा आइटम्स को अपडेट करें (जैसे डिस्प्ले ऑर्डर), या उन्हें पूरी तरह से हटा दें।
* **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}`
किसी कलेक्शन के भीतर किसी ग्रुप में एक या अधिक प्रोडक्ट्स जोड़ें।
किसी ग्रुप के भीतर किसी प्रोडक्ट आइटम को अपडेट करें।
किसी ग्रुप से किसी प्रोडक्ट आइटम को निकालें।
## सर्वश्रेष्ठ प्रथाएँ
* **Group logically**: प्रोडक्ट्स को बिलिंग अंतराल (मासिक/वार्षिक) या फीचर टियर (स्टार्टर/प्रो/एंटरप्राइज़) द्वारा व्यवस्थित करें
* **Order strategically**: अपने सबसे लोकप्रिय या सिफारिश किए गए प्लान को पहले रखें, क्योंकि यह चेकआउट में पहले से चुना जाएगा
* **Use clear naming**: प्रोडक्ट नाम मूल्य अंतरों की स्पष्ट रूप से संप्रेषण करना चाहिए
* **Enable both directions**: ग्राहकों को लचीलापन देने के लिए अपग्रेड और डाउनग्रेड दोनों की अनुमति दें
* **Consider proration**: अपने व्यापार मॉडल के साथ संरेखित एक प्ररोशन मोड चुनें
* **Test thoroughly**: लाइव होने से पहले चेकआउट और प्लान परिवर्तन फ्लो को परीक्षण मोड में सत्यापित करें
अब आप प्रोडक्ट कलेक्शंस बनाने और ग्राहकों को एकीकृत प्लान चयन अनुभव प्रदान करने के लिए तैयार हैं।
संग्रह में जोड़ने के लिए एक-बार, सब्सक्रिप्शन, या उपयोग-आधारित प्रोडक्ट्स बनाएं।
एकीकृत चेकआउट अनुभव में संग्रह प्रोडक्ट्स को प्रदर्शित करें।
ग्राहकों को एक ही कलेक्शन के भीतर अपग्रेड या डाउनग्रेड करने दें।
प्ररोशन और योजना परिवर्तनों के साथ आवर्ती योजना का प्रबंधन करें।