તમારી એપમાં ચુકવણી કેવી રીતે ઉમેરશો: ચેકઆઉટ, સબ્સ્ક્રિપ્શન અને વેબહૂક

તમારી એપમાં ચુકવણી ઉમેરવાની સૌથી સરળ રીત Stripe છે: જો તમને ફક્ત "Buy" બટનની જરૂર હોય અને ઓર્ડર હાથે સંભાળી શકો તો Payment Link વાપરો, જો તમારી એપને જાણવું હોય કે કોણે ચુકવણી કરી અને આપમેળે પ્રતિસાદ આપવો હોય તો Stripe Checkout વાપરો, અને રિકરિંગ બિલિંગ માટે સબ્સ્ક્રિપ્શન મોડમાં Checkout તથા Stripe નું customer portal વાપરો. સૌથી સરળ સિવાયના દરેક કિસ્સામાં તમને વેબહૂક પણ જોઈએ — એક સર્વર એન્ડપોઇન્ટ જેને ચુકવણી સફળ થાય ત્યારે Stripe કૉલ કરે છે — અને લાઇવ કી પર જતા પહેલા Stripe ની ટેસ્ટ કી અને ટેસ્ટ કાર્ડથી બધું ચકાસો.

આ માર્ગદર્શિકા દરેક વિકલ્પ સમજાવે છે, એ વેબહૂક ભાગ જે મોટાભાગના ટ્યુટોરિયલ છોડી દે છે, અને વાસ્તવિક પૈસા લેતા પહેલા શું તપાસવું. Stripe ની વિગતો સપ્ટેમ્બર 2026 સુધીના Stripe ના પોતાના દસ્તાવેજોમાંથી છે.

શા માટે પેમેન્ટ પ્રદાતા વાપરવો

તમારા પોતાના ફોર્મમાં ક્યારેય કાર્ડ નંબર એકઠા ન કરો. કાચો કાર્ડ ડેટા સંભાળવાથી તમે PCI DSS (કાર્ડ ઉદ્યોગનું સુરક્ષા ધોરણ) ના દાયરામાં આવો છો અને તે ગંભીર જોખમ છે. Stripe જેવો પેમેન્ટ પ્રદાતા ચુકવણી ફોર્મ હોસ્ટ કરે છે, કાર્ડ સંગ્રહે છે, બેંક પ્રમાણીકરણ સંભાળે છે, અને પરિણામ તમારી એપને કહે છે. તમારી એપ ફક્ત "ગ્રાહક X એ Y માટે ચુકવણી કરી" જ જુએ છે.

આ માર્ગદર્શિકા Stripe વાપરે છે કારણ કે તે વ્યાપક રીતે વપરાય છે, સારી રીતે દસ્તાવેજીકૃત છે, અને મોટાભાગના AI એપ બિલ્ડર તેને સપોર્ટ કરે છે. બીજા પ્રદાતાઓ પણ છે, અને કેટલાક "merchant of record" તરીકે કામ કરે છે, એટલે કે તેઓ તમારા માટે વેચાણ ટેક્સનું સંચાલન લે છે; જો ટેક્સ પાલન તમને ચિંતિત કરે, તો તે મોડેલની સરખામણી કરવા જેવી છે.

Stripe થી ચુકવણી લેવાની ત્રણ રીત

Payment Links

Payment Link એ Stripe-હોસ્ટેડ ચુકવણી પેજ છે જે તમે કોડ વગર Stripe Dashboard માં બનાવો છો. તમને એક URL મળે છે જે તમે તમારી એપમાં બટન પાછળ મૂકી શકો, ઇમેઇલમાં શેર કરી શકો, અથવા QR કોડ તરીકે બતાવી શકો. Stripe ના દસ્તાવેજ કહે છે કે Payment Links ઉત્પાદન, સબ્સ્ક્રિપ્શન વેચી શકે, અથવા દાન સ્વીકારી શકે, અને તમે ગ્રાહકોને શું ચૂકવવું તે પસંદ કરવા દઈ શકો અથવા ખરીદીની સંખ્યા મર્યાદિત કરી શકો.

મુશ્કેલી: તમારી એપ આપમેળે જાણતી નથી કે કોઈ ચોક્કસ લૉગ-ઇન વપરાશકર્તાએ ચુકવણી કરી. દાન પેજ કે નાની દુકાન માટે, જ્યાં તમે Stripe ના ઇમેઇલ સૂચનાઓ પરથી હાથે ઓર્ડર પૂરા કરો છો, તે ઠીક છે. "Pro ફીચર અનલૉક કરવા ચૂકવો" માટે તે ઠીક નથી.

Stripe Checkout

Checkout એ ચુકવણી પેજ છે જે તમારો સર્વર ચોક્કસ ખરીદી માટે માંગ પર બનાવે છે. તમારો સર્વર Stripe ને કહે છે કે શું ખરીદાઈ રહ્યું છે (અને વૈકલ્પિક રીતે કયો ગ્રાહક ખરીદી રહ્યો છે), Stripe એક URL પાછું આપે છે, અને તમે ગ્રાહકને ત્યાં મોકલો છો. Stripe ના દસ્તાવેજ તેને એકવારની અને સબ્સ્ક્રિપ્શન બંને ચુકવણીને સપોર્ટ કરતું વર્ણવે છે, સંપૂર્ણ Stripe-હોસ્ટેડ પેજ તરીકે, તમારી સાઇટમાં એમ્બેડ કરેલા પેજ તરીકે, અથવા એમ્બેડ કરેલા ફોર્મ તરીકે.

પ્રવાહ:

1. ગ્રાહક તમારી એપમાં Buy પર ક્લિક કરે છે.
2. તમારો સર્વર તમારી સિક્રેટ કી વાપરીને Checkout Session બનાવે છે, જેમાં એક ID શામેલ છે જે તેને તમારા વપરાશકર્તા કે ઓર્ડર સાથે જોડે છે.
3. ગ્રાહકને Stripe પર મોકલાય છે અને તે ચુકવણી કરે છે.
4. Stripe તેમને તમારા સફળતા પેજ પર પાછા મોકલે છે.
5. Stripe તમારા વેબહૂક પર checkout.session.completed ઇવેન્ટ મોકલે છે, અને તમારો સર્વર ઓર્ડર ચૂકવાયેલો ચિહ્નિત કરે છે અથવા ઍક્સેસ અનલૉક કરે છે.

પગલું 2 સર્વર પર થવું જોઈએ, કારણ કે તે તમારી સિક્રેટ કી વાપરે છે. Checkout ને બેકએન્ડ જોઈએ તેનું મુખ્ય કારણ આ છે.

સબ્સ્ક્રિપ્શન

સબ્સ્ક્રિપ્શન Checkout ને સબ્સ્ક્રિપ્શન મોડમાં વાપરે છે, જેમાં તમે Stripe માં સેટ કરેલી રિકરિંગ કિંમત હોય છે. પહેલી ચુકવણી ઉપરના પ્રવાહ જેવી કામ કરે છે. ત્યાર પછી, રિન્યુઅલ, નિષ્ફળ કાર્ડ, અપગ્રેડ અને રદ્દીકરણ સમય જતાં થાય છે — ઘણીવાર ગ્રાહક તમારી એપમાં ન હોય ત્યારે — તેથી તમારી એપ તેમના વિશે ફક્ત વેબહૂક દ્વારા જાણે છે.

ગ્રાહકોને પોતાનું સબ્સ્ક્રિપ્શન સંચાલિત કરવા દેવા માટે, Stripe એક હોસ્ટેડ customer portal આપે છે. Stripe ના દસ્તાવેજ પ્રમાણે, ગ્રાહકો ત્યાં ચુકવણી પદ્ધતિ અને બિલિંગ વિગતો અપડેટ કરી શકે છે, સબ્સ્ક્રિપ્શન બદલી કે રદ કરી શકે છે, અને ઇન્વૉઇસ જોઈ તથા ડાઉનલોડ કરી શકે છે. તમે તેને Stripe Dashboard માં ગોઠવો અને "Manage billing" બટન ઉમેરો જે ગ્રાહકને ત્યાં મોકલે. આથી એ સ્ક્રીન તમારે જાતે બનાવવી પડતી નથી.

વેબહૂક: જે તમે છોડી શકતા નથી

વેબહૂક એ HTTP વિનંતી છે જે કંઈક થાય ત્યારે Stripe તમારા સર્વરને મોકલે છે. (સામાન્ય ખ્યાલ માટે વેબહૂક શું છે જુઓ.) Stripe નું ઓર્ડર પૂરો કરવા માટેનું માર્ગદર્શન સ્પષ્ટ છે: ઓર્ડર પૂરા કરવા માટે ફક્ત સફળતા પેજ પર આધાર ન રાખો, કારણ કે ગ્રાહક ચુકવણી કરી શકે અને તે પેજ લોડ થાય તે પહેલાં તેનું કનેક્શન ગુમાવી શકે. સબ્સ્ક્રિપ્શન અને વિલંબિત ચુકવણી પદ્ધતિઓ માટે વેબહૂક જરૂરી છે.

હેન્ડલ કરવા જેવી ઇવેન્ટ

સાચા વેબહૂક હેન્ડલર માટેના નિયમો

આ સીધા Stripe ના વેબહૂક દસ્તાવેજમાંથી છે, અને AI-બનાવેલા હેન્ડલર ક્યારેક તેમાંથી એક ચૂકી જાય છે:

• સિગ્નેચર ચકાસો. દરેક ઇવેન્ટમાં Stripe-Signature હેડર હોય છે. તમારો હેન્ડલર એન્ડપોઇન્ટની સાઇનિંગ સિક્રેટ (જે whsec_ થી શરૂ થાય છે) વાપરીને તે ચકાસે છે. આ વિના, કોઈપણ તમારા સર્વરને નકલી "payment succeeded" મોકલી શકે.
• કાચો રિક્વેસ્ટ બોડી વાપરો. જો તમારું ફ્રેમવર્ક પહેલા બોડી પાર્સ કે બદલે, તો સિગ્નેચર ચકાસણી નિષ્ફળ જાય છે.
• ઝડપથી 2xx પ્રતિસાદ આપો, પછી ધીમું કામ કરો. ટાઇમઆઉટ નિષ્ફળતા ગણાય છે.
• ડુપ્લિકેટ સંભાળો. Stripe એક જ ઇવેન્ટ એક કરતાં વધુ વખત મોકલી શકે. પ્રક્રિયા થયેલા ઇવેન્ટ IDs નોંધો, અથવા ફુલફિલમેન્ટ બે વાર ચલાવવું સુરક્ષિત બનાવો.
• ક્રમ ધારી ન લો. Stripe ગેરંટી આપતું નથી કે ઇવેન્ટ જે ક્રમમાં બની તે ક્રમમાં આવશે.
• મોડા આવવાની અપેક્ષા રાખો. લાઇવ મોડમાં Stripe નિષ્ફળ ડિલિવરી ત્રણ દિવસ સુધી ફરી પ્રયાસ કરે છે, તેથી ટૂંકી આઉટેજથી ચુકવણી ખોવાતી નથી — પરંતુ તમારા હેન્ડલરે મોડા આવેલી ઇવેન્ટ સંભાળવી પડે.

વેબહૂકને જાહેર HTTPS સરનામું જોઈએ, તેથી તે સામાન્ય રીતે ત્યારે જ કામ કરે છે જ્યારે તમારી એપ પબ્લિશ થયેલી હોય (Stripe નું CLI ડેવલપર્સ માટે ઇવેન્ટ્સને સ્થાનિક મશીન પર ફોરવર્ડ કરી શકે છે).

આખા પ્રવાહને આવરી લેતો પ્રોમ્પ્ટ

"Pro pack" માટે Stripe Checkout સાથે એકવારની ખરીદી ઉમેરો (પ્રાઇસ ID STRIPE_PRICE_ID માં). સિક્રેટ્સમાંથી STRIPE_SECRET_KEY વાપરીને સર્વર પર Checkout Session બનાવો, અને session માં લૉગ-ઇન વપરાશકર્તાની ID શામેલ કરો. POST /api/stripe/webhook એન્ડપોઇન્ટ ઉમેરો જે કાચા રિક્વેસ્ટ બોડીનો ઉપયોગ કરીને STRIPE_WEBHOOK_SECRET વડે Stripe સિગ્નેચર ચકાસે, checkout.session.completed હેન્ડલ કરે, અને તે વપરાશકર્તાને Pro pack ધરાવતો ચિહ્નિત કરે. જો એ જ ઇવેન્ટ બે વાર આવે તો તે સુરક્ષિત રહે. સફળતા અને રદ્દ પેજ. સિક્રેટ કી ક્યારેય બ્રાઉઝરમાં ખુલ્લી ન કરો.

સબ્સ્ક્રિપ્શન માટે ઉમેરો: "STRIPE_PRICE_ID સાથે subscription મોડ વાપરો. invoice.paid, invoice.payment_failed, customer.subscription.updated અને customer.subscription.deleted હેન્ડલ કરો. Stripe customer portal ખોલતું Manage billing બટન ઉમેરો."

ટેસ્ટ મોડ

Stripe પાસે અલગ કી સાથે અલગ sandbox (ટેસ્ટ) અને લાઇવ વાતાવરણ છે. Sandbox કી pk_test_, sk_test_ અથવા rk_test_ થી શરૂ થાય છે; લાઇવ કી pk_live_, sk_live_ અથવા rk_live_ થી શરૂ થાય છે. ટેસ્ટ વ્યવહારો પૈસા ખસેડતા નથી.

Stripe ના ટેસ્ટિંગ દસ્તાવેજમાંથી ઉપયોગી ટેસ્ટ કાર્ડ (કોઈપણ ભાવિ એક્સપાયરી તારીખ, કોઈપણ ત્રણ-અંકનું CVC):

ઓછામાં ઓછું ચકાસો:

• સફળ ચુકવણી યોગ્ય વપરાશકર્તા માટે યોગ્ય વસ્તુ અનલૉક કરે છે
• નકારાયેલું કાર્ડ સ્પષ્ટ સંદેશ બતાવે અને કંઈ અનલૉક ન કરે
• ચુકવણી પછી તરત બ્રાઉઝર ટૅબ બંધ કરવા છતાં ઍક્સેસ મળે (આ સાબિત કરે છે કે વેબહૂક કામ કરે છે, ફક્ત સફળતા પેજ નહીં)
• Stripe પેજ પર રદ કરવાથી વપરાશકર્તા તમારી એપમાં પાછો આવે અને કંઈ ચાર્જ ન થાય
• સબ્સ્ક્રિપ્શન માટે: customer portal માં રદ કરો અને ચકાસો કે ઍક્સેસ યોગ્ય સમયે સમાપ્ત થાય છે

લાઇવ જવું

1. તમારું બિઝનેસ અને બેંક વિગતો સાથે Stripe ખાતું સક્રિય કરો.
2. તમારી એપના સિક્રેટ્સમાં લાઇવ કી બદલો. Stripe ભલામણ કરે છે કે અનિયંત્રિત સિક્રેટ કીને બદલે ફક્ત તમારા ઇન્ટિગ્રેશનને જરૂરી પરવાનગી સાથે પ્રતિબંધિત કી વાપરો.
3. તમારી પબ્લિશ થયેલી એપ તરફ નિર્દેશ કરતો લાઇવ વેબહૂક એન્ડપોઇન્ટ બનાવો. તેની પોતાની સાઇનિંગ સિક્રેટ છે, ટેસ્ટ કરતાં અલગ — તેને અપડેટ કરો.
4. લાઇવ મોડમાં ઉત્પાદનો અને કિંમતો ફરી બનાવો; ટેસ્ટ-મોડના ID ત્યાં અસ્તિત્વમાં નથી.
5. એક વાસ્તવિક નાની ખરીદી કરો અને તેનું રિફંડ કરો.

દરેક કી તમારા પ્રોજેક્ટના સિક્રેટ્સમાં રાખો, ક્યારેય કોડ કે ચેટમાં નહીં. અમારી સુરક્ષા ચેકલિસ્ટ કી અને વેબહૂક ચકાસણી વિશે વધુ વિગતવાર આવરી લે છે.

ટેક્સ, રિફંડ અને કાગળકામ

ચુકવણી એવી જવાબદારીઓ લાવે છે જે કોડ ઉકેલતો નથી. આ ટેક્સ સલાહ નથી; હિસાબનીશ સાથે તપાસો.

• વેચાણ ટેક્સ, VAT અને GST. તમે અને તમારા ગ્રાહકો ક્યાં છો તેના આધારે, તમારે નોંધણી કરાવવી, ટેક્સ વસૂલવો અને ફાઇલ કરવો પડી શકે. Stripe Tax ચેકઆઉટ પર ટેક્સ ગણી અને વસૂલી શકે, તમારા વેચાણથી જવાબદારી ક્યાં ઊભી થઈ શકે તે પર નજર રાખી શકે, અને નોંધણી તથા ફાઇલિંગમાં મદદ કરી શકે — પરંતુ જવાબદારી તમારી પાસે જ રહે છે. Merchant-of-record પ્રદાતાઓ વિકલ્પ છે જે તેમાંથી વધુ સંભાળે છે.
• રિફંડ અને વિવાદો. લૉન્ચ પહેલાં તમારી રિફંડ નીતિ નક્કી કરો અને તમારી સાઇટ પર મૂકો. વિવાદો (chargebacks) થાય છે; શું ખરીદાયું અને પહોંચાડાયું તેના રેકોર્ડ રાખો.
• રસીદો અને ઇન્વૉઇસ. Stripe રસીદો ઇમેઇલ કરી શકે છે; વ્યવસાયોને યોગ્ય ઇન્વૉઇસ જોઈએ.
• ફી. દરેક પ્રદાતા દરેક વ્યવહાર પર ચાર્જ કરે છે. લેખોના આંકડા પર આધાર રાખવાને બદલે પ્રદાતાનું વર્તમાન કિંમત પેજ તપાસો.

તમારી એપને કયું સેટઅપ બંધબેસે છે

• દાન અથવા થોડાં ઉત્પાદનો: Payment Links. જુઓ નફાકારક સંસ્થાની દાન વેબસાઇટ કેવી રીતે બનાવશો.
• કાર્ટ સાથેનો સ્ટોર: લાઇન આઇટમ અને વેબહૂક સાથે Checkout. જુઓ ઓનલાઇન સ્ટોર કેવી રીતે બનાવશો.
• SaaS અથવા સભ્યપદ: સબ્સ્ક્રિપ્શન મોડમાં Checkout, વેબહૂક અને customer portal. જુઓ SaaS MVP કેવી રીતે બનાવશો અને SaaS ઉત્પાદનની કિંમત કેવી રીતે નક્કી કરશો.
• વિક્રેતાઓને ચૂકવણી કરતું માર્કેટપ્લેસ: એક અલગ, વધુ નિયંત્રિત સેટઅપ (Stripe Connect અથવા સમાન). તેના માટે અલગથી યોજના બનાવો.

Mythex પર ચુકવણી ઉમેરવી

Mythex પર તમે બનાવેલી એપમાં ચુકવણી તમારા પોતાના Stripe ખાતા અને કી વાપરે છે; તમારી એપ માટે "Connect Stripe" નું એક-ક્લિક વિકલ્પ નથી. સામાન્ય પ્રવાહ:

1. Stripe ટેસ્ટ કી મેળવો.
2. STRIPE_SECRET_KEY (અને પછી વેબહૂક સિક્રેટ) પ્રોજેક્ટ સિક્રેટ્સમાં ઉમેરો — /secrets દ્વારા, પ્રોજેક્ટ સેટિંગ્સ દ્વારા, અથવા એજન્ટ કીની જરૂર પડે ત્યારે બતાવે તે સિક્રેટ્સ કાર્ડ દ્વારા.
3. ઉપરના જેવા પ્રોમ્પ્ટ વાપરીને એજન્ટને Checkout માટે કહો.
4. ટેસ્ટ કાર્ડ વડે Preview માં ચકાસો. વેબહૂક નોંધાવતા પહેલા પબ્લિશ કરો, કારણ કે તેને તમારું જાહેર URL જોઈએ.
5. લાઇવ કી પર બદલ્યા પછી, લાઇવ એપ તેમને ઉપાડે તે માટે ફરી પબ્લિશ કરો.

દસ્તાવેજમાં Stripe થી ચુકવણી સ્વીકારો અને તમારા બેકએન્ડમાં વેબહૂક હેન્ડલ કરો જુઓ.

પ્રશ્નો