सदस्यताएँ

​

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

• 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 योजनाएँ जिनमें स्पष्ट अंतर हो
• मूल्य निर्धारण संप्रेषित करें: कुल, प्रोरशन, और अगली नवीनीकरण दिखाएँ
• परीक्षणों का विवेकपूर्ण उपयोग करें: ऑनबोर्डिंग के साथ परिवर्तित करें, केवल समय नहीं
• ऐड-ऑन का लाभ उठाएँ: आधार योजनाओं को सरल रखें और अतिरिक्त बेचें
• परिवर्तनों का परीक्षण करें: परीक्षण मोड में योजना परिवर्तनों और प्रोरशन को मान्य करें