Stripe सह सबस्क्रिप्शन्स कसे जोडावेत: योजना, ट्रायल्स, webhooks आणि अयशस्वी पेमेंट्स

Stripe सह सबस्क्रिप्शन्स जोडण्यासाठी, Stripe Dashboard मध्ये आवर्ती किमतीसह उत्पादन तयार करा, तुमच्या server वरून ग्राहकांना subscription mode मधील Stripe Checkout वर पाठवा, आणि प्रत्येक पेमेंट यशस्वी, अयशस्वी, बदलले किंवा संपले तेव्हा तुमच्या अ‍ॅपला सांगण्यासाठी webhook वापरा. प्रवेश success पानावरून नव्हे, तर सबस्क्रिप्शन स्थिती वापरकर्त्याशी साठवून त्यावरून द्या. लोकांना कार्ड बदलता, योजना बदलता आणि रद्द करता यावे यासाठी Manage billing बटण जोडा, जे Stripe च्या होस्ट केलेल्या customer portal कडे जाते — त्या स्क्रीन्स तुम्हाला बांधाव्या लागत नाहीत.

हे मार्गदर्शक तुमच्या अ‍ॅपमध्ये पेमेंट्स कसे जोडावेत वर आधारित आहे, जे एकदाच्या Checkout, test mode आणि लाइव्ह जाण्याबद्दल सांगते. इथे आपण आवर्ती बिलिंगमध्ये वेगळे काय आहे यावर लक्ष केंद्रित करतो. Stripe तपशील Stripe च्या दस्तऐवजातून सप्टेंबर 2026 पर्यंतचे आहेत.

सबस्क्रिप्शन्स एकदाच्या पेमेंटपेक्षा अवघड का असतात

एकदाचे पेमेंट ग्राहक तुमच्या अ‍ॅपमध्ये असताना होते. सबस्क्रिप्शन ग्राहक निघून गेल्यानंतरही चालू राहते: दर महिन्याला नूतनीकरण, संपणारी कार्ड्स, मध्येच अपग्रेड्स, कालावधीच्या शेवटी प्रभावी होणारी रद्दीकरणे. तुमच्या अ‍ॅपला हे फक्त webhooks द्वारे कळते. बहुतेक सबस्क्रिप्शन बग्स पहिल्या पेमेंटलाच संपूर्ण कथा समजण्यातून येतात.

तुमचे पर्याय

बहुतेक अ‍ॅप्ससाठी, Checkout आणि portal हा योग्य समतोल आहे. कर हाताळणी तुम्हाला महत्त्वाची वाटत असेल तर प्रदात्यांची तुलना Stripe vs Paddle vs Lemon Squeezy मध्ये करा.

आधी Stripe मध्ये किंमत ठरवा

Stripe मध्ये उत्पादन म्हणजे तुम्ही काय विकता ("Pro plan") आणि किंमत म्हणजे त्यासाठी किती आकारता ("$20 प्रति महिना", "$200 प्रति वर्ष"). एका उत्पादनाला अनेक किमती असू शकतात. ठरवा:

• कोणत्या स्तरांच्या योजना देता आणि प्रत्येक योजना तुमच्या अ‍ॅपमध्ये काय अनलॉक करते
• मासिक, वार्षिक, की दोन्ही
• ट्रायल द्यायची का, आणि त्यासाठी आधी कार्ड लागते का

उत्पादने आणि किमती test mode मध्ये तयार करा आणि त्यांचे price IDs ठेवा; तुमचे अ‍ॅप त्यांचा संदर्भ देते. किंमत अजून ठरली नसेल तर SaaS उत्पादनाची किंमत कशी ठरवावी आणि freemium विरुद्ध मोफत ट्रायल वाचा.

तुम्हाला हाताळावे लागणारे सबस्क्रिप्शन जीवनचक्र

Stripe च्या सबस्क्रिप्शन्स overview मध्ये सबस्क्रिप्शनच्या स्थिती दिल्या आहेत. प्रवेशासाठी सर्वात महत्त्वाच्या:

सबस्क्रिप्शन स्थिती तुमच्या वापरकर्ता किंवा खाते रेकॉर्डवर साठवा आणि प्रवेश त्यावर आधारित ठेवा. संबंधित webhook आल्यावर ती प्रत्येक वेळी अपडेट करा.

हाताळायचे webhook इव्हेंट्स

Stripe च्या webhook दस्तऐवजातील हँडलर नियम अजूनही लागू: raw body वापरून सही तपासा, लवकर 2xx द्या, डुप्लिकेट आणि क्रमाबाहेरचे इव्हेंट्स हाताळा, आणि पुनःप्रयत्नांची अपेक्षा ठेवा. webhook म्हणजे काय मार्गदर्शक ती कल्पना समजावते, आणि पेमेंट्स मार्गदर्शकात नियम तपशिलात आहेत.

टप्प्याटप्प्याने

1. Stripe test mode मध्ये उत्पादने आणि किमती तयार करा.
2. Secrets जोडा: secret key, price IDs, आणि नंतर webhook signing secret. ते कधीही फ्रंटएंड कोडमध्ये ठेवू नका.
3. किंमत पान: प्रत्येक योजनेचे बटण तुमच्या server कडे कॉल करते, जो लॉग-इन केलेल्या वापरकर्त्यासाठी subscription mode मध्ये Checkout Session तयार करतो. webhook पेमेंट खात्याशी जुळवू शकावे म्हणून वापरकर्त्याचा ID जोडा.
4. Webhook endpoint: सह्या तपासा आणि वरील इव्हेंट्स हाताळा, प्रति वापरकर्ता एक सबस्क्रिप्शन रेकॉर्ड अपडेट करत.
5. वैशिष्ट्ये गेट करा साठवलेल्या स्थिती आणि योजनेवर, प्रत्येक संरक्षित क्रियेसाठी server वर तपासून, फक्त लपवलेल्या बटणांवर नव्हे.
6. Customer portal: Stripe Dashboard मध्ये कॉन्फिगर करा (लोक कोणत्या योजनांवर जाऊ शकतात, ते रद्द करू शकतात का), मग Manage billing बटण जोडा जे server वर portal session तयार करते आणि तिथे redirect करते.
7. अयशस्वी पेमेंट्स: Stripe च्या बिलिंग सेटिंग्जमध्ये पुनःप्रयत्न वर्तन आणि शेवटच्या पुनःप्रयत्नानंतर काय होते ते निवडा. past_due असताना अ‍ॅपमध्ये बॅनर दाखवा.
8. संपूर्ण जीवनचक्र तपासा, मग प्रकाशित करा आणि लाइव्ह webhook नोंदवा.

तुमच्या AI बिल्डरला दिलेले प्रॉम्प्ट्स

Stripe सह सबस्क्रिप्शन बिलिंग जोडा. योजना: Starter (price ID STRIPE_PRICE_STARTER मध्ये) आणि Pro (STRIPE_PRICE_PRO). किंमत पान server वर STRIPE_SECRET_KEY वापरून subscription mode मध्ये Checkout Session तयार करते, लॉग-इन केलेल्या वापरकर्त्याचा ID जोडलेला. वापरकर्त्यावर Stripe customer ID, subscription ID, योजना आणि स्थिती साठवा. गुप्त key कधीही ब्राउझरला उघड करू नका.

POST /api/stripe/webhook जोडा. raw request body वापरून STRIPE_WEBHOOK_SECRET ने सही तपासा. checkout.session.completed, invoice.paid, invoice.payment_failed, customer.subscription.updated, customer.subscription.deleted आणि customer.subscription.trial_will_end हाताळा. डुप्लिकेट इव्हेंट्स दुर्लक्षित व्हावेत म्हणून प्रक्रिया झालेले इव्हेंट IDs नोंदवा. वापरकर्त्याची स्थिती subscription ऑब्जेक्टवरून अपडेट करा, इव्हेंट्स ज्या क्रमाने येतात त्यावरून नव्हे.

Pro वैशिष्ट्ये server वर गेट करा: स्थिती active किंवा trialing आणि योजना Pro असेल तेव्हाच परवानगी द्या. स्थिती past_due असताना "पेमेंट अयशस्वी, कृपया कार्ड अपडेट करा" बॅनर दाखवा. या वापरकर्त्यासाठी Stripe customer portal उघडणारे Manage billing बटण जोडा.

अपग्रेड्स, डाउनग्रेड्स आणि प्रोरेशन

ग्राहक योजना बदलतो तेव्हा, Stripe च्या दस्तऐवजानुसार बदलामुळे अनेकदा प्रोरेशन तयार होते: नवीन किंमत चालू बिलिंग कालावधीच्या उरलेल्या भागावर लागू होते. तुम्ही प्रोरेशनचे पूर्वावलोकन करू शकता किंवा ते बंद करू शकता. जर योजनांचा कालावधी सारखा असेल तर बिलिंग तारखा तशाच राहतात; मासिकवरून वार्षिकवर गेल्यास बिलिंग तारीख बदलाच्या दिवशी हलते. Portal मध्ये ग्राहकांना बदल करू देणे हा तर्क लिहिण्याचे काम वाचवते, पण portal सेटिंग्जमध्ये कोणते बदल परवानगीयोग्य आहेत ते ठरवा.

चाचणी चेकलिस्ट

Stripe test mode आणि test cards वापरा, आणि प्रत्येक स्थिती तपासा:

• नवीन सबस्क्रिप्शन योग्य वापरकर्त्याला योग्य योजना देते
• पैसे दिल्यानंतर लगेच टॅब बंद केला तरी प्रवेश मिळतो (webhook काम करतो हे सिद्ध करते)
• साइन-अपवर नाकारलेल्या कार्डने काहीच मिळत नाही
• अयशस्वी नूतनीकरणामुळे खाते past_due होते आणि बॅनर दिसतो
• portal मध्ये कार्ड अपडेट केल्याने active स्थिती परत येते
• अपग्रेड आणि डाउनग्रेडमुळे वैशिष्ट्ये योग्य बदलतात
• कालावधीच्या शेवटी रद्द केल्यास शेवटच्या तारखेपर्यंत प्रवेश राहतो, मग काढला जातो
• ट्रायल वापरकर्त्यांना प्रवेश मिळतो, आठवण मिळते, आणि ते योग्यरीत्या रूपांतरित होतात किंवा प्रवेश गमावतात
• तोच webhook इव्हेंट दोनदा पाठवल्याने काहीही बदलत नाही

Stripe चे test clocks तुम्हाला वेळ जाताना सिम्युलेट करू देतात, त्यामुळे महिना वाट न पाहता नूतनीकरणांची चाचणी करता येते. ते कसे वापरायचे ते Stripe च्या सध्याच्या testing दस्तऐवजात तपासा.

सामान्य चुका

• success पानावर प्रवेश देणे. ग्राहक पैसे देऊ शकतो आणि ते पान कधीच पाहू शकत नाही. webhook वापरा.
• फक्त पहिल्या पेमेंटची हाताळणी. नूतनीकरणे, अपयश आणि रद्दीकरणे नंतर इव्हेंट्स म्हणून येतात.
• योजना स्थिती फक्त फ्रंटएंडवर तपासणे. कोणीही तुमच्या API ला थेट कॉल करू शकतो.
• चुकून एका वापरकर्त्याला अनेक सबस्क्रिप्शन्स. नवीन Checkout Session तयार करण्यापूर्वी विद्यमान सबस्क्रिप्शन तपासा, किंवा विद्यमान ग्राहकांना portal कडे पाठवा.
• पहिले अयशस्वी नूतनीकरण होताच प्रवेश काढणे. कार्डे साध्या कारणांनी अयशस्वी होतात. थोडा सवलत कालावधी आणि स्पष्ट बॅनर ग्राहक टिकवतो.
• लाइव्ह webhook विसरणे. Test आणि लाइव्ह endpoints ची signing secrets वेगळी असतात.
• कर आणि परतावे दुर्लक्षित करणे. लाँचपूर्वी तुमचे परतावा धोरण ठरवा आणि तुमच्या कर जबाबदाऱ्या अकाउंटंटकडे तपासा.

Mythex वर सबस्क्रिप्शन्स

Mythex वर बांधलेले अ‍ॅप्स तुमचे स्वतःचे Stripe खाते आणि keys वापरतात; तुमच्या अ‍ॅपसाठी एक-क्लिक Stripe कनेक्शन नाही. तुमच्या test keys आणि price IDs प्रोजेक्ट secrets म्हणून जोडा, वरील प्रॉम्प्ट्ससारखे प्रॉम्प्ट्स वापरा, आणि Preview मध्ये Stripe च्या test cards सह तपासा. Webhooks ला तुमच्या अ‍ॅपचा सार्वजनिक URL लागतो, त्यामुळे Stripe मध्ये endpoint नोंदवण्यापूर्वी प्रकाशित करा, आणि लाइव्ह keys वर बदलल्यानंतर पुन्हा प्रकाशित करा जेणेकरून लाइव्ह अ‍ॅप त्या उचलेल. Accept payments with Stripe आणि Handle webhooks in your backend पहा. विस्तृत उत्पादनासाठी, SaaS MVP कसा बनवावा बिलिंगभोवती काय बांधायचे ते कव्हर करते.

प्रश्न