सदस्यताएँ

​

सदस्यताएँ क्या हैं?

• SaaS लाइसेंस: ऐप्स, APIs, या प्लेटफ़ॉर्म पहुंच
• सदस्यताएँ: समुदाय, कार्यक्रम, या क्लब
• डिजिटल सामग्री: पाठ्यक्रम, मीडिया, या प्रीमियम सामग्री
• समर्थन योजनाएँ: SLA, सफलता पैकेज, या रखरखाव

​

प्रमुख लाभ

• पूर्वानुमानित राजस्व: स्वचालित नवीनीकरण के साथ आवर्ती बिलिंग
• लचीले चक्र: मासिक, वार्षिक, कस्टम अंतराल, और परीक्षण
• योजना चपलता: अपग्रेड और डाउनग्रेड के लिए प्रोरशन
• ऐड-ऑन और सीटें: वैकल्पिक, मात्रात्मक अपग्रेड संलग्न करें
• सहज चेकआउट: होस्टेड चेकआउट और ग्राहक पोर्टल
• डेवलपर-प्रथम: निर्माण, परिवर्तन, और उपयोग ट्रैकिंग के लिए स्पष्ट APIs

​

सदस्यताएँ बनाना

​

सदस्यता उत्पाद निर्माण

​

उत्पाद विवरण

• उत्पाद नाम (आवश्यक): चेकआउट, ग्राहक पोर्टल, और चालानों में प्रदर्शित नाम।
• उत्पाद विवरण (आवश्यक): एक स्पष्ट मूल्य वक्तव्य जो चेकआउट और चालानों में दिखाई देता है।
• उत्पाद छवि (आवश्यक): PNG/JPG/WebP 3 MB तक। चेकआउट और चालानों पर उपयोग किया जाता है।
• ब्रांड: थीमिंग और ईमेल के लिए उत्पाद को एक विशिष्ट ब्रांड से जोड़ें।
• कर श्रेणी (आवश्यक): कर नियम निर्धारित करने के लिए श्रेणी चुनें (उदाहरण के लिए, SaaS)।

​

मूल्य निर्धारण

• मूल्य निर्धारण प्रकार: सदस्यता (यह गाइड)। विकल्प एकल भुगतान और उपयोग आधारित बिलिंग हैं।
• मूल्य (आवश्यक): मुद्रा के साथ आधार आवर्ती मूल्य।
• छूट लागू (%): आधार मूल्य पर लागू वैकल्पिक प्रतिशत छूट; चेकआउट और चालानों में दर्शाई गई।
• हर बार पुनरावृत्ति भुगतान (आवश्यक): नवीनीकरण के लिए अंतराल, जैसे, हर 1 माह। ताल (महीने या वर्ष) और मात्रा चुनें।
• सदस्यता अवधि (आवश्यक): कुल अवधि जिसके लिए सदस्यता सक्रिय रहती है (जैसे, 10 वर्ष)। इस अवधि के समाप्त होने के बाद, नवीनीकरण रुक जाते हैं जब तक कि इसे बढ़ाया न जाए।
• परीक्षण अवधि दिन (आवश्यक): दिनों में परीक्षण की लंबाई सेट करें। परीक्षणों को अक्षम करने के लिए 0 का उपयोग करें। पहली चार्ज स्वचालित रूप से तब होती है जब परीक्षण समाप्त होता है।
• ऐड-ऑन चुनें: आधार योजना के साथ खरीदने के लिए 3 तक के ऐड-ऑन संलग्न करें।

​

उन्नत सेटिंग्स

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

​

सदस्यता परीक्षण

​

परीक्षण कॉन्फ़िगर करना

// Via subscription creation
const subscription = await client.subscriptions.create({
  customer_id: 'cus_123',
  product_id: 'prod_monthly',
  trial_period_days: 14  // Overrides product's trial period
});

// Via checkout session
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_monthly', quantity: 1 }],
  subscription_data: { trial_period_days: 14 }
});

​

परीक्षण स्थिति का पता लगाना

const subscription = await client.subscriptions.retrieve('sub_123');
const payments = await client.payments.list({
  subscription_id: subscription.subscription_id
});

// Check if subscription is in trial
const isInTrial = payments.items.length === 1 && 
                  payments.items[0].total_amount === 0;

​

परीक्षण अवधि को अपडेट करना

await client.subscriptions.update('sub_123', {
  next_billing_date: '2025-02-15T00:00:00Z'  // New trial end date
});

​

सदस्यता योजना परिवर्तन

​

प्रोरशन मोड्स

​

prorated_immediately

await client.subscriptions.changePlan('sub_123', {
  product_id: 'prod_pro',
  quantity: 1,
  proration_billing_mode: 'prorated_immediately'
});

​

difference_immediately

// Upgrade: charges $50 (difference between $30 and $80)
// Downgrade: credits remaining value, auto-applied to renewals
await client.subscriptions.changePlan('sub_123', {
  product_id: 'prod_pro',
  quantity: 1,
  proration_billing_mode: 'difference_immediately'
});

​

full_immediately

await client.subscriptions.changePlan('sub_123', {
  product_id: 'prod_monthly',
  quantity: 1,
  proration_billing_mode: 'full_immediately'
});

​

ऐड-ऑन के साथ योजनाएं बदलना

await client.subscriptions.changePlan('sub_123', {
  product_id: 'prod_pro',
  quantity: 1,
  proration_billing_mode: 'difference_immediately',
  addons: [{ addon_id: 'addon_extra_seats', quantity: 2 }]  // Add add-ons
  // addons: []  // Empty array removes all existing add-ons
});

​

योजना परिवर्तनों का पूर्वावलोकन

const preview = await client.subscriptions.previewChangePlan('sub_123', {
  product_id: 'prod_pro',
  quantity: 1,
  proration_billing_mode: 'prorated_immediately'
});

// Show customer the charge before confirming
console.log('You will be charged:', preview.immediate_charge.summary);

​

सब्सक्रिप्शन राज्य

• active: सब्सक्रिप्शन सक्रिय है और स्वचालित रूप से नवीनीकरण होगा
• on_hold: सब्सक्रिप्शन असफल भुगतान के कारण स्थगित है। पुनः सक्रिय करने के लिए भुगतान विधि अपडेट की आवश्यकता है
• cancelled: सब्सक्रिप्शन रद्द कर दिया गया है और नवीनीकरण नहीं होगा
• expired: सब्सक्रिप्शन अपनी समाप्ति तिथि पर पहुँच गया है
• pending: सब्सक्रिप्शन बनाया जा रहा है या संसाधित किया जा रहा है

​

होल्ड स्थिति

• एक नवीनीकरण भुगतान असफल होता है (अपर्याप्त धन, समाप्त कार्ड, आदि)
• एक योजना परिवर्तन चार्ज असफल होता है
• भुगतान विधि प्राधिकरण असफल होता है

​

होल्ड से पुनः सक्रिय करना

1. शेष बकाया के लिए एक चार्ज बनाता है
2. एक चालान उत्पन्न करता है
3. नए भुगतान विधि का उपयोग करके भुगतान संसाधित करता है
4. सफल भुगतान पर सब्सक्रिप्शन को active स्थिति में पुनः सक्रिय करता है

// Reactivate subscription from on_hold
const response = await client.subscriptions.updatePaymentMethod('sub_123', {
  type: 'new',
  return_url: 'https://example.com/return'
});

// For on_hold subscriptions, a charge is automatically created
if (response.payment_id) {
  console.log('Charge created:', response.payment_id);
  // Redirect customer to response.payment_link to complete payment
  // Monitor webhooks for payment.succeeded and subscription.active
}

​

API प्रबंधन

​

सामान्य उपयोग के मामले

• SaaS और APIs: सीटों या उपयोग के लिए स्तरित पहुंच के साथ ऐड-ऑन
• सामग्री और मीडिया: परिचयात्मक परीक्षणों के साथ मासिक पहुंच
• B2B समर्थन योजनाएं: प्रीमियम समर्थन ऐड-ऑन के साथ वार्षिक अनुबंध
• उपकरण और प्लगइन्स: लाइसेंस कुंजी और संस्करणित रिलीज़

​

एकीकरण उदाहरण

​

चेकआउट सत्र (सब्सक्रिप्शन)

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'prod_subscription',
      quantity: 1
    }
  ]
});

​

प्रोरशन के साथ योजना परिवर्तन

await client.subscriptions.changePlan('sub_123', {
  product_id: 'prod_new',
  quantity: 1,
  proration_billing_mode: 'difference_immediately'
});

​

अवधि के अंत में रद्द करें

await client.subscriptions.update('sub_123', {
  cancel_at_period_end: true
});

​

ऑन-डिमांड सब्सक्रिप्शन

const onDemand = await client.subscriptions.create({
  customer_id: 'cus_123',
  product_id: 'prod_on_demand',
  on_demand: true
});

await client.subscriptions.createCharge(onDemand.id, {
  amount: 4900,
  currency: 'USD',
  description: 'Extra usage for September'
});

​

सक्रिय सब्सक्रिप्शन के लिए भुगतान विधि अपडेट करें

// Update with new payment method
const response = await client.subscriptions.updatePaymentMethod('sub_123', {
  type: 'new',
  return_url: 'https://example.com/return'
});

// Or use existing payment method
await client.subscriptions.updatePaymentMethod('sub_123', {
  type: 'existing',
  payment_method_id: 'pm_abc123'
});

​

होल्ड से सब्सक्रिप्शन को पुनः सक्रिय करें

// Update payment method - automatically creates charge for remaining dues
const response = await client.subscriptions.updatePaymentMethod('sub_123', {
  type: 'new',
  return_url: 'https://example.com/return'
});

if (response.payment_id) {
  // Charge created for remaining dues
  // Redirect customer to response.payment_link
  // Monitor webhooks: payment.succeeded → subscription.active
}

​

RBI-अनुरूप आदेशों के साथ सब्सक्रिप्शन

​

आदेश सीमाएँ

• रु 15,000 से कम चार्ज: हम रु 15,000 INR के लिए एक ऑन-डिमांड आदेश बनाते हैं। सब्सक्रिप्शन राशि आपके सब्सक्रिप्शन की आवृत्ति के अनुसार समय-समय पर चार्ज की जाती है, आदेश सीमा तक।
• रु 15,000 या उससे अधिक चार्ज: हम सटीक सब्सक्रिप्शन राशि के लिए एक सब्सक्रिप्शन आदेश (या ऑन-डिमांड आदेश) बनाते हैं।

​

अपग्रेड और डाउनग्रेड पर विचार

• यदि एक अपग्रेड/डाउनग्रेड का परिणाम चार्ज राशि में होता है जो रु 15,000 से अधिक है और मौजूदा ऑन-डिमांड भुगतान सीमा से परे है, तो लेनदेन चार्ज असफल हो सकता है।
• ऐसे मामलों में, ग्राहक को अपनी भुगतान विधि को अपडेट करने या सही सीमा के साथ एक नया आदेश स्थापित करने के लिए सब्सक्रिप्शन को फिर से बदलने की आवश्यकता हो सकती है।

​

उच्च-मूल्य चार्ज के लिए प्राधिकरण

• ग्राहक को लेनदेन को अधिकृत करने के लिए अपने बैंक द्वारा प्रेरित किया जाएगा।
• यदि ग्राहक लेनदेन को अधिकृत करने में विफल रहता है, तो लेनदेन असफल होगा और सब्सक्रिप्शन होल्ड पर डाल दिया जाएगा।

​

48-घंटे की प्रसंस्करण देरी

• चार्ज आपके सब्सक्रिप्शन की आवृत्ति के अनुसार निर्धारित तिथि पर आरंभ होते हैं।
• ग्राहक के खाते से वास्तविक कटौती केवल भुगतान आरंभ होने के 48 घंटे बाद होती है।
• यह 48-घंटे की विंडो बैंक API प्रतिक्रियाओं के आधार पर 2-3 अतिरिक्त घंटे तक बढ़ सकती है।

​

आदेश रद्द करने की विंडो

• ग्राहक अपने बैंकिंग ऐप के माध्यम से आदेश रद्द कर सकते हैं।
• यदि ग्राहक इस अवधि के दौरान आदेश रद्द करता है, तो सब्सक्रिप्शन सक्रिय रहेगा (यह भारतीय कार्ड और UPI ऑटो-पे सब्सक्रिप्शन के लिए विशिष्ट एक किनारे का मामला है)।
• हालाँकि, वास्तविक कटौती असफल हो सकती है, और उस मामले में, हम सब्सक्रिप्शन को होल्ड पर डाल देंगे।

• भुगतान पुष्टि तक लाभ सक्रियण में देरी करना
• अनुग्रह अवधि या अस्थायी पहुंच लागू करना
• आदेश रद्दीकरण के लिए सब्सक्रिप्शन स्थिति की निगरानी करना
• अपने एप्लिकेशन लॉजिक में सब्सक्रिप्शन होल्ड राज्यों को संभालना

​

सर्वोत्तम प्रथाएँ

• स्पष्ट स्तरों से शुरू करें: 2–3 योजनाएँ जिनमें स्पष्ट अंतर हैं
• मूल्य निर्धारण संप्रेषित करें: कुल, प्रोरशन, और अगली नवीनीकरण दिखाएँ
• परीक्षणों का विवेकपूर्ण उपयोग करें: केवल समय नहीं, बल्कि ऑनबोर्डिंग के साथ परिवर्तित करें
• ऐड-ऑन का लाभ उठाएँ: आधार योजनाओं को सरल रखें और अतिरिक्त बिक्री करें
• परिवर्तनों का परीक्षण करें: परीक्षण मोड में योजना परिवर्तनों और प्रोरशन को मान्य करें