உங்கள் ஆப்பில் பணம் செலுத்தலை எப்படி சேர்ப்பது: Checkout, Subscriptions மற்றும் Webhooks

உங்கள் ஆப்பில் பணம் செலுத்தலைச் சேர்க்க எளிய வழி Stripe: உங்களுக்கு "Buy" பொத்தான் மட்டும் தேவைப்பட்டு ஆர்டர்களை கைமுறையாகக் கையாள முடிந்தால் Payment Link-ஐப் பயன்படுத்துங்கள்; யார் பணம் செலுத்தினார் என்பதை உங்கள் ஆப் அறிந்து தானாக எதிர்வினையாற்ற வேண்டுமென்றால் Stripe Checkout-ஐப் பயன்படுத்துங்கள்; தொடர் கட்டணத்திற்கு subscription mode-இல் Checkout மற்றும் Stripe-இன் customer portal-ஐப் பயன்படுத்துங்கள். மிக எளிய வகையைத் தவிர எல்லா நிலைகளிலும், உங்களுக்கு webhook தேவை — பணம் வெற்றிகரமாகச் செலுத்தப்படும்போது Stripe அழைக்கும் ஒரு சர்வர் endpoint — மேலும் live keys-க்கு மாறுவதற்கு முன் எல்லாவற்றையும் Stripe-இன் test keys மற்றும் test cards மூலம் சோதிக்க வேண்டும்.

இந்த வழிகாட்டி ஒவ்வொரு விருப்பத்தையும், பெரும்பாலான பயிற்சிகள் தவிர்க்கும் webhook பகுதியையும், உண்மையான பணத்தைப் பெறுவதற்கு முன் சரிபார்க்க வேண்டியவற்றையும் விளக்குகிறது. Stripe விவரங்கள் செப்டம்பர் 2026 நிலவரப்படி Stripe-இன் சொந்த ஆவணத்திலிருந்து எடுக்கப்பட்டவை.

பணம் செலுத்தும் provider-ஐ ஏன் பயன்படுத்த வேண்டும்

உங்கள் சொந்தப் படிவங்களில் அட்டை எண்களை ஒருபோதும் சேகரிக்காதீர்கள். மூல அட்டை தரவைக் கையாள்வது உங்களை PCI DSS (அட்டைத் தொழில்துறையின் பாதுகாப்புத் தரம்) வரம்புக்குள் கொண்டுவரும், மேலும் அது கடுமையான பொறுப்பு. Stripe போன்ற பணம் செலுத்தும் provider பணம் செலுத்தும் படிவத்தை hosts செய்கிறது, அட்டையைச் சேமிக்கிறது, வங்கி அங்கீகாரத்தைக் கையாள்கிறது, முடிவை உங்கள் ஆப்பிற்குச் சொல்கிறது. உங்கள் ஆப் எப்போதும் "வாடிக்கையாளர் X, Y-க்குப் பணம் செலுத்தினார்" என்பதை மட்டுமே பார்க்கிறது.

இந்த வழிகாட்டி Stripe-ஐப் பயன்படுத்துகிறது, ஏனெனில் அது பரவலாகப் பயன்படுத்தப்படுகிறது, நன்கு ஆவணப்படுத்தப்பட்டது, பெரும்பாலான AI app builders ஆதரிக்கின்றன. வேறு providers-உம் உள்ளன, சிலர் "merchant of record" ஆக இருந்து விற்பனை வரி கையாளுதலை உங்களுக்காக ஏற்கின்றனர்; வரி இணக்கம் உங்களுக்குக் கவலையாக இருந்தால், அந்த மாதிரியை ஒப்பிட்டுப் பார்ப்பது மதிப்புள்ளது.

Stripe மூலம் பணம் பெறும் மூன்று வழிகள்

Payment Links

Payment Link என்பது Stripe Dashboard-இல் code இல்லாமல் நீங்கள் உருவாக்கும் Stripe hosts செய்யும் பணம் செலுத்தும் பக்கம். உங்கள் ஆப்பில் ஒரு பொத்தானுக்குப் பின்னால் வைக்கலாம், மின்னஞ்சலில் பகிரலாம், அல்லது QR code ஆகக் காட்டலாம். Payment Links ஒரு பொருள், ஒரு subscription விற்கலாம் அல்லது நன்கொடை ஏற்கலாம் என்று Stripe-இன் ஆவணம் கூறுகிறது, மேலும் வாடிக்கையாளர்கள் எதற்குப் பணம் செலுத்துவது என்று தேர்ந்தெடுக்கலாம் அல்லது கொள்முதல்களின் எண்ணிக்கையை வரம்பிடலாம்.

சிக்கல்: குறிப்பிட்ட உள்நுழைந்த பயனர் பணம் செலுத்தினார் என்பதை உங்கள் ஆப் தானாக அறியாது. நன்கொடைப் பக்கம் அல்லது Stripe-இன் மின்னஞ்சல் அறிவிப்புகளிலிருந்து ஆர்டர்களை கைமுறையாக நிறைவேற்றும் ஒரு சிறிய கடைக்கு அது சரி. "Pro அம்சங்களைத் திறக்க பணம் செலுத்து" என்பதற்கு அது சரியில்லை.

Stripe Checkout

Checkout என்பது குறிப்பிட்ட ஒரு கொள்முதலுக்காக உங்கள் சர்வர் தேவைக்கேற்ப உருவாக்கும் பணம் செலுத்தும் பக்கம். என்ன வாங்கப்படுகிறது (மற்றும் விருப்பமாக எந்த வாடிக்கையாளர் வாங்குகிறார்) என்பதை உங்கள் சர்வர் Stripe-க்குச் சொல்கிறது, Stripe ஒரு URL-ஐத் திருப்பித் தருகிறது, நீங்கள் வாடிக்கையாளரை அங்கு அனுப்புகிறீர்கள். Stripe-இன் ஆவணம் இதை ஒரு முறை மற்றும் subscription பணம் இரண்டையும் ஆதரிப்பதாக விவரிக்கிறது; முழு Stripe-hosted பக்கமாக, உங்கள் தளத்தில் உட்பொதிக்கப்பட்ட பக்கமாக, அல்லது உட்பொதிக்கப்பட்ட படிவமாக.

ஓட்டம்:

1. வாடிக்கையாளர் உங்கள் ஆப்பில் Buy என்பதைக் கிளிக் செய்கிறார்.
2. உங்கள் சர்வர் உங்கள் secret key-ஐப் பயன்படுத்தி ஒரு Checkout Session-ஐ உருவாக்குகிறது, அதை உங்கள் பயனர் அல்லது ஆர்டருடன் இணைக்கும் ID-ஐ உள்ளடக்கி.
3. வாடிக்கையாளர் Stripe-க்கு திருப்பிவிடப்பட்டு பணம் செலுத்துகிறார்.
4. Stripe அவர்களை உங்கள் success பக்கத்திற்குத் திருப்பி அனுப்புகிறது.
5. Stripe checkout.session.completed நிகழ்வை உங்கள் webhook-க்கு அனுப்புகிறது, உங்கள் சர்வர் ஆர்டரை செலுத்தியதாகக் குறிக்கிறது அல்லது அணுகலைத் திறக்கிறது.

படி 2 சர்வரில் நடக்க வேண்டும், ஏனெனில் அது உங்கள் secret key-ஐப் பயன்படுத்துகிறது. Checkout-க்கு backend தேவைப்படுவதற்கு முக்கிய காரணம் இதுவே.

Subscriptions

Subscriptions, Stripe-இல் நீங்கள் அமைத்த தொடர்ச்சியான விலையுடன் subscription mode-இல் Checkout-ஐப் பயன்படுத்துகின்றன. முதல் பணம் மேலே உள்ள ஓட்டம் போலவே செயல்படுகிறது. அதன் பிறகு, புதுப்பிப்புகள், தோல்வியடைந்த அட்டைகள், மேம்படுத்தல்கள் மற்றும் ரத்துசெய்தல்கள் காலப்போக்கில் நடக்கும் — பெரும்பாலும் வாடிக்கையாளர் உங்கள் ஆப்பில் இல்லாத போது — எனவே உங்கள் ஆப் அவற்றை webhooks மூலம் மட்டுமே அறிகிறது.

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

Webhooks: தவிர்க்க முடியாத பகுதி

Webhook என்பது ஏதாவது நடக்கும்போது Stripe உங்கள் சர்வருக்கு அனுப்பும் HTTP கோரிக்கை. (பொதுவான கருத்துக்கு webhook என்றால் என்ன பார்க்கவும்.) Stripe-இன் fulfilment வழிகாட்டி தெளிவாகச் சொல்கிறது: வாடிக்கையாளர் பணம் செலுத்திவிட்டு அந்தப் பக்கம் ஏற்றப்படுவதற்கு முன் இணைப்பை இழக்கக்கூடும் என்பதால், ஆர்டர்களை நிறைவேற்ற success பக்கத்தை மட்டும் நம்ப முடியாது. subscriptions மற்றும் தாமதமான பணம் செலுத்தும் முறைகளுக்கு webhooks கட்டாயம்.

கையாளத் தகுந்த நிகழ்வுகள்

சரியான webhook handler-க்கான விதிகள்

இவை நேரடியாக Stripe-இன் webhook ஆவணத்திலிருந்து வருகின்றன, AI-உருவாக்கிய handlers சில நேரங்களில் ஒன்றை விடுகின்றன:

• Signature-ஐச் சரிபார்க்கவும். ஒவ்வொரு நிகழ்வும் Stripe-Signature header-ஐ உள்ளடக்கியது. உங்கள் handler அதை endpoint-இன் signing secret (அது whsec_ என்பதில் தொடங்கும்) மூலம் சரிபார்க்கிறது. இது இல்லாமல், யார் வேண்டுமானாலும் உங்கள் சர்வருக்கு போலி "பணம் வெற்றிகரமாகச் செலுத்தப்பட்டது" அனுப்பலாம்.
• மூல request body-ஐப் பயன்படுத்துங்கள். உங்கள் framework body-ஐ முதலில் parse செய்தாலோ மாற்றினாலோ signature சரிபார்ப்புகள் தோல்வியடையும்.
• விரைவாக 2xx பதிலளியுங்கள், பிறகு மெதுவான வேலையைச் செய்யுங்கள். timeouts தோல்விகளாகக் கணக்கிடப்படும்.
• நகல்களைக் கையாளுங்கள். Stripe ஒரே நிகழ்வை ஒன்றுக்கு மேற்பட்ட முறை அனுப்பலாம். செயலாக்கிய நிகழ்வு IDs-ஐப் பதிவு செய்யுங்கள், அல்லது நிறைவேற்றுதலை இரண்டு முறை இயக்கினாலும் பாதுகாப்பானதாக்குங்கள்.
• வரிசையை அனுமானிக்காதீர்கள். நிகழ்வுகள் நடந்த வரிசையிலேயே வரும் என்று Stripe உத்தரவாதம் அளிப்பதில்லை.
• மீண்டும் முயற்சிகளை எதிர்பாருங்கள். live mode-இல் தோல்வியடைந்த அனுப்புதல்களை Stripe மூன்று நாட்கள் வரை மீண்டும் முயற்சிக்கிறது, எனவே குறுகிய செயலிழப்பில் பணம் இழக்கப்படாது — ஆனால் உங்கள் handler தாமதமான நிகழ்வுகளைச் சமாளிக்க வேண்டும்.

Webhooks-க்கு பொது HTTPS முகவரி தேவை, எனவே உங்கள் ஆப் வெளியிடப்பட்ட பின்னரே அவை பொதுவாக வேலை செய்யும் (டெவலப்பர்களுக்கு Stripe CLI நிகழ்வுகளை உள்ளூர் கணினிக்கு forward செய்ய முடியும்).

முழு ஓட்டத்தையும் உள்ளடக்கும் ஒரு prompt

"Pro pack"-க்கு Stripe Checkout மூலம் ஒரு முறை கொள்முதலைச் சேர்க்கவும் (price ID STRIPE_PRICE_ID-இல்). secrets-இலிருந்து STRIPE_SECRET_KEY-ஐப் பயன்படுத்தி Checkout Session-ஐ சர்வரில் உருவாக்கவும், session-இல் உள்நுழைந்த பயனரின் ID-ஐச் சேர்க்கவும். POST /api/stripe/webhook endpoint-ஐச் சேர்க்கவும், அது மூல request body-ஐப் பயன்படுத்தி STRIPE_WEBHOOK_SECRET மூலம் Stripe signature-ஐ சரிபார்க்கும், checkout.session.completed-ஐக் கையாளும், அந்தப் பயனர் Pro pack வைத்திருப்பதாகக் குறிக்கும். அதே நிகழ்வு இரண்டு முறை வந்தாலும் பாதுகாப்பாக இருக்கட்டும். Success மற்றும் cancel பக்கங்கள். secret key-ஐ ஒருபோதும் browser-க்கு வெளிப்படுத்தாதீர்கள்.

Subscriptions-க்கு, சேர்க்கவும்: "STRIPE_PRICE_ID உடன் subscription mode-ஐப் பயன்படுத்தவும். invoice.paid, invoice.payment_failed, customer.subscription.updated மற்றும் customer.subscription.deleted-ஐக் கையாளவும். Stripe customer portal-ஐத் திறக்கும் Manage billing பொத்தானைச் சேர்க்கவும்."

Test mode

Stripe-க்கு தனித்தனி keys உடன் தனித்தனி sandbox (test) மற்றும் live சூழல்கள் உண்டு. Sandbox keys pk_test_, sk_test_ அல்லது rk_test_ என்பதில் தொடங்கும்; live keys pk_live_, sk_live_ அல்லது rk_live_ என்பதில் தொடங்கும். Test பரிவர்த்தனைகள் பணத்தை நகர்த்துவதில்லை.

Stripe-இன் testing ஆவணத்திலிருந்து பயனுள்ள test cards (எதிர்கால expiry தேதி, மூன்று இலக்க CVC எதுவாக இருந்தாலும்):

குறைந்தபட்சம் இவற்றைச் சோதியுங்கள்:

• வெற்றிகரமான பணம் சரியான பயனருக்கு சரியானதைத் திறக்கிறது
• நிராகரிக்கப்பட்ட அட்டை தெளிவான செய்தியைக் காட்டுகிறது, எதையும் திறக்கவில்லை
• பணம் செலுத்திய உடனே browser tab-ஐ மூடினாலும் அணுகல் கிடைக்கிறது (இது success பக்கம் அல்ல, webhook வேலை செய்கிறது என்பதை நிரூபிக்கிறது)
• Stripe பக்கத்தில் ரத்து செய்தால் பயனர் உங்கள் ஆப்புக்குத் திரும்புகிறார், எதுவும் வசூலிக்கப்படவில்லை
• subscriptions-க்கு: customer portal-இல் ரத்து செய்து, அது எப்போது முடிய வேண்டுமோ அப்போது அணுகல் முடிகிறதா என்று உறுதிப்படுத்தவும்

Live-க்குச் செல்வது

1. உங்கள் வணிக மற்றும் வங்கி விவரங்களுடன் உங்கள் Stripe கணக்கை செயல்படுத்துங்கள்.
2. உங்கள் ஆப்பின் secrets-இல் live keys-ஐ மாற்றுங்கள். கட்டுப்பாடற்ற secret key-க்கு பதிலாக, உங்கள் integration-க்குத் தேவையான அனுமதிகள் மட்டும் உள்ள restricted keys-ஐ Stripe பரிந்துரைக்கிறது.
3. வெளியிடப்பட்ட உங்கள் ஆப்பைச் சுட்டும் live webhook endpoint-ஐ உருவாக்குங்கள். அதற்கு அதன் சொந்த signing secret உண்டு, test-இல் உள்ளதிலிருந்து வேறுபட்டது — அதைப் புதுப்பியுங்கள்.
4. live mode-இல் products மற்றும் prices-ஐ மீண்டும் உருவாக்குங்கள்; test-mode IDs அங்கு இருக்காது.
5. ஒரு உண்மையான சிறிய கொள்முதலைச் செய்து அதைத் திருப்பிச் செலுத்துங்கள்.

ஒவ்வொரு key-ஐயும் உங்கள் திட்டத்தின் secrets-இல் வையுங்கள், code-இலோ chat-இலோ ஒருபோதும் வைக்காதீர்கள். keys மற்றும் webhook சரிபார்ப்பை எங்கள் பாதுகாப்புப் பட்டியல் இன்னும் விரிவாக விளக்குகிறது.

வரிகள், திருப்பிச் செலுத்தல்கள் மற்றும் ஆவணங்கள்

பணம் செலுத்தல்கள் code தீர்க்காத பொறுப்புகளைக் கொண்டுவருகின்றன. இது வரி ஆலோசனை அல்ல; ஒரு கணக்காளரிடம் சரிபாருங்கள்.

• விற்பனை வரி, VAT மற்றும் GST. நீங்களும் உங்கள் வாடிக்கையாளர்களும் எங்கு இருக்கிறீர்கள் என்பதைப் பொறுத்து, நீங்கள் பதிவு செய்ய, வரி வசூலிக்க மற்றும் தாக்கல் செய்ய வேண்டியிருக்கலாம். Stripe Tax checkout-இல் வரியைக் கணக்கிட்டு வசூலிக்கலாம், உங்கள் விற்பனை எங்கு ஒரு பொறுப்பை உருவாக்கக்கூடும் என்பதைக் கண்காணிக்கலாம், பதிவுகள் மற்றும் தாக்கலுக்கு உதவலாம் — ஆனால் பொறுப்பு உங்களிடமே இருக்கும். merchant-of-record providers இவற்றில் அதிகத்தை ஏற்கும் ஒரு மாற்று.
• திருப்பிச் செலுத்தல்கள் மற்றும் சர்ச்சைகள். வெளியிடுவதற்கு முன் உங்கள் திருப்பிச் செலுத்தல் கொள்கையை முடிவு செய்து உங்கள் தளத்தில் வையுங்கள். சர்ச்சைகள் (chargebacks) நடக்கும்; எது வாங்கப்பட்டது, எது வழங்கப்பட்டது என்பதன் பதிவுகளை வையுங்கள்.
• ரசீதுகள் மற்றும் invoices. Stripe ரசீதுகளை மின்னஞ்சல் செய்ய முடியும்; வணிகங்களுக்கு சரியான invoices தேவைப்படலாம்.
• கட்டணங்கள். ஒவ்வொரு provider-உம் ஒவ்வொரு பரிவர்த்தனைக்கும் கட்டணம் வசூலிக்கும். கட்டுரைகளில் உள்ள எண்களை நம்புவதற்கு பதிலாக provider-இன் தற்போதைய விலைப் பக்கத்தைச் சரிபாருங்கள்.

எந்த அமைப்பு உங்கள் ஆப்புக்குப் பொருந்தும்

• நன்கொடைகள் அல்லது சில பொருட்கள்: Payment Links. லாப நோக்கற்ற நன்கொடை தளத்தை எப்படி உருவாக்குவது பார்க்கவும்.
• cart கொண்ட ஒரு கடை: line items மற்றும் webhook உடன் Checkout. ஆன்லைன் கடையை எப்படி உருவாக்குவது பார்க்கவும்.
• SaaS அல்லது உறுப்பினர் திட்டங்கள்: subscription mode-இல் Checkout, webhooks மற்றும் customer portal. SaaS MVP-ஐ எப்படி உருவாக்குவது மற்றும் SaaS தயாரிப்புக்கு விலை நிர்ணயிப்பது எப்படி பார்க்கவும்.
• விற்பனையாளர்களுக்கு பணம் வழங்கும் marketplace: வேறுபட்ட, அதிக ஒழுங்குமுறைக்கு உட்பட்ட அமைப்பு (Stripe Connect அல்லது அதுபோன்றது). அதைத் தனியாகத் திட்டமிடுங்கள்.

Mythex-இல் பணம் செலுத்தலைச் சேர்ப்பது

Mythex-இல் நீங்கள் உருவாக்கும் ஆப்களில் பணம் செலுத்தல்கள் உங்கள் சொந்த Stripe கணக்கு மற்றும் keys-ஐப் பயன்படுத்துகின்றன; உங்கள் ஆப்புக்கு ஒரே கிளிக்கில் "Connect Stripe" இல்லை. வழக்கமான ஓட்டம்:

1. Stripe test keys-ஐப் பெறுங்கள்.
2. STRIPE_SECRET_KEY (மற்றும் பின்னர் webhook secret) ஐ project secrets-இல் சேர்க்கவும் — /secrets, project settings, அல்லது முகவர் ஒரு key தேவைப்படும்போது காட்டும் secrets அட்டை வழியாக.
3. மேலே உள்ளது போன்ற prompt பயன்படுத்தி முகவரிடம் Checkout கேளுங்கள்.
4. test அட்டைகளுடன் Preview-இல் சோதியுங்கள். webhook-ஐப் பதிவு செய்வதற்கு முன் publish செய்யுங்கள், ஏனெனில் அதற்கு உங்கள் பொது URL தேவை.
5. live keys-க்கு மாற்றிய பின், live ஆப் அவற்றை எடுத்துக்கொள்ள மீண்டும் publish செய்யுங்கள்.

ஆவணங்களில் Stripe மூலம் பணம் ஏற்கவும் மற்றும் உங்கள் backend-இல் webhooks-ஐக் கையாளவும் பார்க்கவும்.

கேள்விகள்