Stripe மூலம் Subscriptions-ஐ எப்படி சேர்ப்பது: Plans, Trials, Webhooks மற்றும் தோல்வியடைந்த பணம்

Stripe மூலம் subscriptions-ஐச் சேர்க்க, Stripe Dashboard-இல் தொடர் விலையுடன் ஒரு product-ஐ உருவாக்குங்கள், உங்கள் சர்வரிலிருந்து வாடிக்கையாளர்களை subscription mode-இல் Stripe Checkout-க்கு அனுப்புங்கள், ஒவ்வொரு பணமும் வெற்றிபெறும், தோல்வியடையும், மாறும் அல்லது முடியும்போது உங்கள் ஆப்பிற்கு webhook சொல்லட்டும். subscription நிலையை பயனருடன் சேமித்து, அதன் அடிப்படையில் அணுகலை வழங்குங்கள், success பக்கத்திலிருந்து அல்ல. அட்டைகளை மாற்றவும், திட்டங்களை மாற்றவும், ரத்து செய்யவும் மக்கள் பயன்படுத்தக்கூடிய, Stripe-இன் hosted customer portal-ஐத் திறக்கும் Manage billing பொத்தானைச் சேருங்கள் — அந்தத் திரைகளை நீங்களே உருவாக்க வேண்டியதில்லை.

இந்த வழிகாட்டி உங்கள் ஆப்பில் பணம் செலுத்தலை எப்படி சேர்ப்பது மீது கட்டப்பட்டது, அது ஒரு முறை Checkout, test mode மற்றும் live செல்வதை உள்ளடக்குகிறது. இங்கு தொடர் கட்டணத்தில் உள்ள வேறுபாடுகளில் கவனம் செலுத்துகிறோம். Stripe விவரங்கள் செப்டம்பர் 2026 நிலவரப்படி Stripe-இன் ஆவணத்திலிருந்து.

Subscriptions ஏன் ஒரு முறை பணத்தை விடக் கடினம்

ஒரு முறை பணம் வாடிக்கையாளர் உங்கள் ஆப்பில் இருக்கும்போதே நடக்கும். subscription அவர்கள் வெளியேறிய பிறகும் தொடர்ந்து நடக்கிறது: ஒவ்வொரு மாதமும் புதுப்பிப்புகள், காலாவதியாகும் அட்டைகள், சுழற்சியின் நடுவில் மேம்படுத்தல்கள், காலக்கெடுவின் முடிவில் நடைமுறைக்கு வரும் ரத்துகள். உங்கள் ஆப் இவற்றை webhooks மூலம் மட்டுமே அறிகிறது. பெரும்பாலான subscription பிழைகள் முதல் பணத்தையே முழு கதையாகக் கருதுவதிலிருந்து வருகின்றன.

உங்கள் விருப்பங்கள்

பெரும்பாலான ஆப்களுக்கு, Checkout மற்றும் portal தான் சரியான சமநிலை. வரி கையாளுதல் உங்களுக்கு கவலையாக இருந்தால் Stripe vs Paddle vs Lemon Squeezy ஒப்பிடுங்கள்.

முதலில் Stripe-இல் உங்கள் விலை நிர்ணயத்தைத் திட்டமிடுங்கள்

Stripe-இல், product என்பது நீங்கள் விற்பது ("Pro plan"), price என்பது அதற்கு எவ்வாறு கட்டணம் வசூலிப்பது ("மாதத்திற்கு $20", "ஆண்டுக்கு $200"). ஒரு product-க்கு பல prices இருக்கலாம். முடிவு செய்யுங்கள்:

• நீங்கள் எந்த அடுக்குகளை வழங்குகிறீர்கள், ஒவ்வொன்றும் உங்கள் ஆப்பில் எதைத் திறக்கிறது
• மாதாந்திரம், ஆண்டுதோறும், அல்லது இரண்டும்
• trial வழங்குகிறீர்களா, அது முன்கூட்டியே அட்டை தேவைப்படுகிறதா

products மற்றும் prices-ஐ test mode-இல் உருவாக்கி, அவற்றின் price IDs-ஐ வையுங்கள்; உங்கள் ஆப் அவற்றைக் குறிப்பிடுகிறது. விலை நிர்ணயம் முடிவாகவில்லை என்றால், SaaS தயாரிப்புக்கு விலை நிர்ணயிப்பது எப்படி மற்றும் freemium எதிர் இலவச trial படியுங்கள்.

நீங்கள் கையாள வேண்டிய subscription வாழ்க்கைச் சுழற்சி

Stripe-இன் subscriptions overview ஒரு subscription கொண்டிருக்கக்கூடிய நிலைகளைப் பட்டியலிடுகிறது. அணுகலுக்கு மிக முக்கியமானவை:

நிலையை உங்கள் பயனர் அல்லது கணக்குப் பதிவில் சேமித்து, அதன் அடிப்படையில் அணுகலை அமையுங்கள். தொடர்புடைய webhook வரும் ஒவ்வொரு முறையும் அதைப் புதுப்பியுங்கள்.

கையாள வேண்டிய webhook நிகழ்வுகள்

Stripe-இன் webhook ஆவணத்தின் handler விதிகள் இன்னும் பொருந்தும்: raw body மூலம் signature-ஐ சரிபார்க்கவும், விரைவாக 2xx திருப்பவும், நகல் மற்றும் வரிசை தவறிய நிகழ்வுகளைக் கையாளவும், மீண்டும் முயற்சிகளை எதிர்பார்க்கவும். webhook என்றால் என்ன வழிகாட்டி கருத்தை விளக்குகிறது, பணம் செலுத்தும் வழிகாட்டி விதிகளை விரிவாகப் பட்டியலிடுகிறது.

படிப்படியாக

1. Stripe test mode-இல் products மற்றும் prices-ஐ உருவாக்குங்கள்.
2. Secrets-ஐச் சேருங்கள்: secret key, price IDs, பின்னர் webhook signing secret. அவற்றை ஒருபோதும் frontend code-இல் வைக்காதீர்கள்.
3. விலைப் பக்கம்: ஒவ்வொரு திட்டத்தின் பொத்தானும் உங்கள் சர்வரை அழைக்கிறது, அது உள்நுழைந்த பயனருக்கு subscription mode-இல் ஒரு Checkout Session-ஐ உருவாக்குகிறது. பணத்தை கணக்குடன் webhook பொருத்த உங்கள் user ID-ஐ அனுப்புங்கள்.
4. Webhook endpoint: signatures-ஐச் சரிபார்த்து, மேலே உள்ள நிகழ்வுகளைக் கையாண்டு, பயனருக்கு ஒரு subscription பதிவை புதுப்பிக்கவும்.
5. அம்சங்களைக் கட்டுப்படுத்துங்கள் சேமிக்கப்பட்ட நிலை மற்றும் திட்டத்தின் அடிப்படையில், ஒவ்வொரு பாதுகாக்கப்பட்ட செயலுக்கும் சர்வரில் சரிபார்த்து — மறைக்கப்பட்ட பொத்தான்கள் மட்டும் அல்ல.
6. Customer portal: Stripe Dashboard-இல் அதை அமையுங்கள் (மக்கள் எந்தத் திட்டங்களுக்கு மாறலாம், ரத்து செய்யலாமா), பிறகு சர்வரில் portal session-ஐ உருவாக்கி அங்கு திருப்பிவிடும் Manage billing பொத்தானைச் சேருங்கள்.
7. தோல்வியடைந்த பணங்கள்: Stripe-இன் billing அமைப்புகளில், மறுமுயற்சி நடத்தையையும் இறுதி மறுமுயற்சிக்குப் பின் என்ன நடக்கும் என்பதையும் தேர்ந்தெடுக்கவும். past_due இருக்கும்போது ஆப்பில் ஒரு banner காட்டவும்.
8. முழு வாழ்க்கைச் சுழற்சியையும் சோதியுங்கள், பிறகு publish செய்து live webhook-ஐப் பதிவு செய்யுங்கள்.

உங்கள் AI builder-க்குக் கொடுக்க வேண்டிய prompts

Stripe மூலம் subscription billing-ஐச் சேர்க்கவும். திட்டங்கள்: Starter (price ID STRIPE_PRICE_STARTER-இல்) மற்றும் Pro (STRIPE_PRICE_PRO). விலைப் பக்கம் சர்வரில் STRIPE_SECRET_KEY-ஐப் பயன்படுத்தி subscription mode-இல் ஒரு Checkout Session-ஐ உருவாக்குகிறது, உள்நுழைந்த பயனரின் ID இணைக்கப்பட்டு. Stripe customer ID, subscription ID, திட்டம் மற்றும் நிலையை பயனரில் சேமிக்கவும். secret key-ஐ ஒருபோதும் browser-க்கு வெளிப்படுத்தாதீர்கள்.

POST /api/stripe/webhook-ஐச் சேர்க்கவும். raw request body-ஐப் பயன்படுத்தி STRIPE_WEBHOOK_SECRET மூலம் signature-ஐச் சரிபார்க்கவும். checkout.session.completed, invoice.paid, invoice.payment_failed, customer.subscription.updated, customer.subscription.deleted மற்றும் customer.subscription.trial_will_end-ஐக் கையாளவும். நகல்கள் புறக்கணிக்கப்படுமாறு செயலாக்கிய நிகழ்வு IDs-ஐப் பதிவு செய்யவும். நிகழ்வுகள் வந்த வரிசையிலிருந்து அல்ல, subscription object-இலிருந்து பயனரின் நிலையைப் புதுப்பிக்கவும்.

சேவையகத்தில் Pro அம்சங்களைக் கட்டுப்படுத்தவும்: நிலை active அல்லது trialing ஆகவும் திட்டம் Pro ஆகவும் இருக்கும்போது மட்டும் அனுமதிக்கவும். நிலை past_due ஆக இருக்கும்போது "பணம் தோல்வி, உங்கள் அட்டையைப் புதுப்பிக்கவும்" banner-ஐக் காட்டவும். இந்தப் பயனருக்காக Stripe customer portal-ஐத் திறக்கும் Manage billing பொத்தானைச் சேர்க்கவும்.

மேம்படுத்தல்கள், தரம் குறைத்தல் மற்றும் proration

வாடிக்கையாளர் திட்டங்களை மாற்றும்போது, மாற்றம் பெரும்பாலும் proration-ஐ உருவாக்குகிறது என்று Stripe-இன் ஆவணம் கூறுகிறது: புதிய விலை தற்போதைய billing காலத்தின் மீதியில் பயன்படுத்தப்படுகிறது. proration-ஐ முன்னோட்டமிடலாம் அல்லது அணைக்கலாம். திட்டங்களின் இடைவெளி ஒன்றாக இருந்தால், billing தேதிகள் அப்படியே இருக்கும்; மாதாந்திரத்திலிருந்து ஆண்டுக்கு மாறினால் billing தேதி மாறிய நாளுக்கு நகரும். வாடிக்கையாளர்கள் portal-இல் திட்டங்களை மாற்ற அனுமதிப்பது இந்த logic-ஐ எழுதுவதைச் சேமிக்கிறது, ஆனால் portal அமைப்புகளில் எந்த மாற்றங்கள் அனுமதிக்கப்படுகின்றன என்று முடிவு செய்யுங்கள்.

Testing checklist

Stripe test mode மற்றும் test cards-ஐப் பயன்படுத்துங்கள், ஒவ்வொரு நிலையையும் நடந்து பாருங்கள்:

• புதிய subscription சரியான பயனருக்கு சரியான திட்டத்தை வழங்குகிறது
• பணம் செலுத்திய உடனே tab-ஐ மூடினாலும் அணுகல் கிடைக்கிறது (webhook வேலை செய்கிறது என்பதை நிரூபிக்கிறது)
• பதிவின்போது நிராகரிக்கப்பட்ட அட்டை எதையும் வழங்கவில்லை
• தோல்வியடையும் புதுப்பிப்பு கணக்கை past_due-இல் வைத்து banner-ஐக் காட்டுகிறது
• portal-இல் அட்டையைப் புதுப்பிப்பது active நிலையை மீட்டெடுக்கிறது
• மேம்படுத்தல் மற்றும் தரம் குறைத்தல் அம்சங்களை சரியாக மாற்றுகின்றன
• காலக்கெடுவின் முடிவில் ரத்து செய்தால், முடியும் தேதி வரை அணுகல் இருக்கும், பிறகு அகற்றப்படும்
• trial பயனர்களுக்கு அணுகல் கிடைக்கிறது, நினைவூட்டல் கிடைக்கிறது, சரியாக மாறுகின்றனர் அல்லது அணுகலை இழக்கின்றனர்
• ஒரே webhook நிகழ்வை இரண்டு முறை அனுப்பினால் எதுவும் மாறுவதில்லை

Stripe-இன் test clocks நேரம் கடப்பதை உருவகப்படுத்த அனுமதிக்கின்றன, எனவே ஒரு மாதம் காத்திருக்காமல் புதுப்பிப்புகளைச் சோதிக்கலாம். அவற்றை எப்படிப் பயன்படுத்துவது என்று Stripe-இன் தற்போதைய testing ஆவணத்தைச் சரிபாருங்கள்.

பொதுவான தவறுகள்

• success பக்கத்தில் அணுகல் வழங்குவது. வாடிக்கையாளர்கள் பணம் செலுத்தி அதை ஒருபோதும் அடையாமல் போகலாம். webhook-ஐப் பயன்படுத்துங்கள்.
• முதல் பணத்தை மட்டும் கையாள்வது. புதுப்பிப்புகள், தோல்விகள் மற்றும் ரத்துகள் பின்னர் நிகழ்வுகளாக வரும்.
• திட்ட நிலையை frontend-இல் மட்டும் சரிபார்ப்பது. எவரும் உங்கள் API-ஐ நேரடியாக அழைக்கலாம்.
• தற்செயலாக ஒரு பயனருக்கு பல subscriptions. புதிய Checkout Session-ஐ உருவாக்கும் முன் ஏற்கனவே உள்ள subscription இருக்கிறதா என்று சரிபாருங்கள், அல்லது ஏற்கனவே உள்ள வாடிக்கையாளர்களை portal-க்கு அனுப்புங்கள்.
• முதல் தோல்வியடைந்த புதுப்பிப்பிலேயே அணுகலை ரத்து செய்வது. அட்டைகள் சாதாரணக் காரணங்களால் தோல்வியடையும். தெளிவான banner-உடன் கூடிய குறுகிய சலுகைக் காலம் வாடிக்கையாளர்களைத் தக்கவைக்கும்.
• live webhook-ஐ மறப்பது. test மற்றும் live endpoints வெவ்வேறு signing secrets கொண்டவை.
• வரி மற்றும் திருப்பிச் செலுத்தல்களைப் புறக்கணிப்பது. வெளியிடுவதற்கு முன் உங்கள் திருப்பிச் செலுத்தல் கொள்கையை முடிவு செய்து, உங்கள் வரிப் பொறுப்புகளை ஒரு கணக்காளருடன் சரிபாருங்கள்.

Mythex-இல் Subscriptions

Mythex-இல் நீங்கள் உருவாக்கும் ஆப்கள் உங்கள் சொந்த Stripe கணக்கு மற்றும் keys-ஐப் பயன்படுத்துகின்றன; உங்கள் ஆப்புக்கு ஒரே கிளிக்கில் Stripe இணைப்பு இல்லை. உங்கள் test keys மற்றும் price IDs-ஐ project secrets-ஆகச் சேர்த்து, மேலே உள்ளது போன்ற prompts-ஐப் பயன்படுத்தி, Preview-இல் Stripe test cards மூலம் சோதியுங்கள். webhooks-க்கு உங்கள் ஆப்பின் பொது URL தேவை, எனவே Stripe-இல் endpoint-ஐப் பதிவு செய்வதற்கு முன் publish செய்யுங்கள், live keys-க்கு மாறிய பின் live ஆப் அவற்றை எடுத்துக்கொள்ள மீண்டும் publish செய்யுங்கள். Stripe மூலம் பணம் ஏற்கவும் மற்றும் உங்கள் backend-இல் webhooks-ஐக் கையாளவும் பார்க்கவும். பரந்த தயாரிப்புக்கு, SaaS MVP-ஐ எப்படி உருவாக்குவது billing-ஐச் சுற்றி என்ன கட்ட வேண்டும் என்பதை உள்ளடக்குகிறது.

கேள்விகள்