Stripe арқылы жазылымдарды қосу: жоспарлар, сынақ кезеңдері, webhook-тер және сәтсіз төлемдер

Stripe арқылы жазылымдарды қосу үшін Stripe Dashboard-та қайталанатын бағасы бар өнім жасаңыз, серверіңізден клиенттерді Stripe Checkout-қа жазылым режимінде жіберіңіз, ал әр төлем сәтті өткенде, сәтсіз болғанда, өзгергенде немесе аяқталғанда қолданбаңызға webhook хабарлайтын болсын. Жазылым күйін пайдаланушыға байланыстырып сақтаңыз және қолжетімділікті сәтті бетке емес, осы күйге сүйеніп беріңіз. Адамдар карталарды өзгерте, жоспарларды ауыстыра және бас тарта алуы үшін Біллингті басқару түймесін қосыңыз — ол Stripe-тың хостингтелген клиент порталын ашады, сондықтан ол экрандарды өзіңіз құрмайсыз.

Бұл нұсқаулық қолданбаға төлем қалай қосылады бөлімін негізге алады, онда бір реттік Checkout, тест режимі және нақты іске қосу қарастырылған. Мұнда біз қайталанатын біллингтің айырмашылығына назар аударамыз. Stripe мәліметтері 2026 жылдың қыркүйегі бойынша Stripe құжаттамасынан алынған.

Жазылымдар неге бір реттік төлемнен қиын

Бір реттік төлем клиент қолданбаңызда болған кезде жасалады. Жазылым клиент кеткеннен кейін де жұмыс істейді: ай сайынғы жаңартулар, мерзімі өтетін карталар, цикл ортасындағы жоғарылатулар, кезең соңында күшіне енетін бас тартулар. Қолданбаңыз бұлар туралы тек webhook арқылы біледі. Жазылым қателерінің көбі бірінші төлемді бүкіл оқиға деп қабылдаудан шығады.

Опцияларыңыз

Көп қолданбаға Checkout және портал дұрыс компромисс. Салық өңдеуі сізді алаңдатса, Stripe vs Paddle vs Lemon Squeezy бөлімінде провайдерлерді салыстырыңыз.

Алдымен Stripe-та бағаны жоспарлаңыз

Stripe-та өнім — сіз сататын нәрсе («Pro жоспары»), ал баға — оған қалай ақы аласыз («айына $20», «жылына $200»). Бір өнімнің бірнеше бағасы болуы мүмкін. Шешіңіз:

• Қандай деңгейлерді ұсынасыз және әр деңгей қолданбаңызда нені ашады
• Ай сайын, жыл сайын немесе екеуі де
• Сынақ кезеңі болады ма және ол карта алдын ала сұрай ма

Өнімдер мен бағаларды тест режимінде жасаңыз және олардың баға ID-лерін сақтаңыз; қолданбаңыз соларға сілтеме жасайды. Бағаны әлі шешпеген болсаңыз, SaaS өнімінің бағасын қалай белгілеу керек және freemium мен тегін сынақ кезеңі бөлімдерін оқыңыз.

Өңдеуіңіз керек жазылым өмірлік циклі

Stripe жазылымдар шолуы жазылымның ала алатын күйлерін тізеді. Қолжетімділік үшін ең маңыздылары:

Күйді пайдаланушы немесе аккаунт жазбасында сақтаңыз және қолжетімділікті сонда негіздеңіз. Тиісті webhook келген сайын оны жаңартыңыз.

Өңдеу керек webhook оқиғалары

Stripe-тың webhook құжаттамасындағы өңдеуші ережелері әлі де қолданылады: қолтаңбаны шикі денеде тексеріңіз, тез 2xx қайтарыңыз, қайталанған және реттік емес оқиғаларды өңдеңіз, қайталауларды күтіңіз. Webhook дегеніміз не нұсқаулығы идеяны түсіндіреді, ал төлемдер нұсқаулығында ережелер толық тізілген.

Қадам-қадаммен

1. Stripe тест режимінде өнімдер мен бағаларды жасаңыз.
2. Құпияларды қосыңыз: құпия кілт, баға ID-лері, кейінірек webhook қол қою құпиясы. Оларды ешқашан фронтенд кодына салмаңыз.
3. Бағалар беті: әр жоспардың түймесі серверіңізді шақырады, ол кірген пайдаланушы үшін жазылым режиміндегі Checkout Session жасайды. Төлемді аккаунтпен сәйкестендіру үшін пайдаланушы ID-ін беріңіз.
4. Webhook endpoint: қолтаңбаларды тексеріңіз және жоғарыдағы оқиғаларды өңдеңіз, әр пайдаланушы үшін бір жазылым жазбасын жаңартыңыз.
5. Мүмкіндіктерді қорғаңыз сақталған күй мен жоспар бойынша, әр қорғалған әрекетте серверде тексеріп, тек түймелерді жасырмай.
6. Клиент порталы: оны Stripe Dashboard-та баптаңыз (адамдар қандай жоспарға ауыса алады, бас тарта ала ма), содан кейін серверде портал сессиясын жасап, соған бағыттайтын Біллингті басқару түймесін қосыңыз.
7. Сәтсіз төлемдер: Stripe біллинг баптауларында қайталау әрекетін және соңғы қайталаудан кейін не болатынын таңдаңыз. past_due кезінде қолданбада баннер көрсетіңіз.
8. Бүкіл өмірлік циклді сынаңыз, содан кейін жариялап, нақты webhook-ты тіркеңіз.

ЖИ құрастырушыға берілетін промпттар

Stripe арқылы жазылым біллингін қосыңыз. Жоспарлар: Starter (баға ID-і STRIPE_PRICE_STARTER ішінде) және Pro (STRIPE_PRICE_PRO). Бағалар беті серверде STRIPE_SECRET_KEY арқылы жазылым режиміндегі Checkout Session жасайды, кірген пайдаланушының ID-імен. Stripe клиент ID-ін, жазылым ID-ін, жоспарды және күйді пайдаланушыға сақтаңыз. Құпия кілтті браузерге ешқашан көрсетпеңіз.

POST /api/stripe/webhook қосыңыз. Қолтаңбаны STRIPE_WEBHOOK_SECRET арқылы шикі сұрау денесінде тексеріңіз. checkout.session.completed, invoice.paid, invoice.payment_failed, customer.subscription.updated, customer.subscription.deleted және customer.subscription.trial_will_end оқиғаларын өңдеңіз. Өңделген оқиға ID-лерін жазыңыз, сонда қайталанғандар елеусіз қалады. Пайдаланушы күйін оқиғалар келген ретіне емес, жазылым объектісінен жаңартыңыз.

Pro мүмкіндіктерін серверде қорғаңыз: тек күй active немесе trialing және жоспар Pro болғанда ашыңыз. Күй past_due болғанда «төлем сәтсіз, картаңызды жаңартыңыз» баннерін көрсетіңіз. Осы пайдаланушы үшін Stripe клиент порталын ашатын Біллингті басқару түймесін қосыңыз.

Жаңарту, төмендету және пропорционалдық

Клиент жоспарын ауыстырғанда, Stripe құжаттамасы өзгеріс әдетте пропорционалдық есептеу жасайтынын айтады: жаңа баға ағымдағы біллинг кезеңінің қалған бөлігіне қолданылады. Пропорционалдық алдын ала қарауға немесе өшіруге болады. Жоспарлар бір интервалда болса, біллинг күндері өзгермейді; айлықтан жылдыққа ауысқанда біллинг күні ауысу күніне көшеді. Клиенттерге жоспарды порталда өзгерту мүмкіндігін беру осы логиканы жазудан құтқарады, бірақ қай ауысуға рұқсат берілетінін портал баптауларында шешіңіз.

Сынау тізімі

Stripe тест режимін және тест карталарын пайдаланыңыз, әр күйді өтіңіз:

• Жаңа жазылым дұрыс жоспарды дұрыс пайдаланушыға береді
• Төлегеннен кейін браузер қойындысын бірден жапқанның өзінде қолжетімділік бар (бұл webhook жұмыс істейтінін дәлелдейді)
• Тіркелуде карта бас тартылса, ешқандай қолжетімділік берілмейді
• Сәтсіз жаңарту аккаунтты past_due күйіне қояды және баннерді көрсетеді
• Порталда картаны жаңарту белсенді күйді қалпына келтіреді
• Жоспарды жоғарылату және төмендету мүмкіндіктерді дұрыс өзгертеді
• Кезең соңында бас тарту қолжетімділікті аяқталу күніне дейін сақтайды, содан кейін алып тастайды
• Сынақ пайдаланушылары қолжетімділік алады, еске салуды алады және дұрыс ауысады немесе қолжетімділікті жоғалтады
• Бірдей webhook оқиғасы екі рет келсе, ештеңе өзгермейді

Stripe-тың тест сағаттары уақыттың өтуін модельдеуге мүмкіндік береді, сондықтан айды күтпей жаңартуларды сынауға болады. Ағымдағы тест мүмкіндіктері үшін Stripe-тың тест құжаттамасын тексеріңіз.

Жиі кездесетін қателер

• Қолжетімділікті сәтті бетте беру. Клиенттер төлеп, оған жетпеуі мүмкін. Webhook қолданыңыз.
• Тек бірінші төлемді өңдеу. Жаңартулар, сәтсіздіктер және бас тартулар кейінірек оқиға ретінде келеді.
• Жоспар күйін тек фронтендте тексеру. Кез келген адам API-ңізді тікелей шақыра алады.
• Бір пайдаланушыда кездейсоқ көп жазылым. Жаңа Checkout Session жасамас бұрын бар жазылымды тексеріңіз немесе бар клиенттерді портал арқылы жіберіңіз.
• Бірінші сәтсіз жаңартуда қолжетімділікті алып тастау. Карталар кәдімгі себептермен сәтсіз болады. Анық баннері бар қысқа рақымшылық кезеңі клиенттерді сақтайды.
• Нақты webhook-ты ұмыту. Тест және нақты endpoint-терде әртүрлі қол қою құпиялары бар.
• Салық пен қайтаруды елемеу. Қайтару саясатын шешіңіз және ысыққа дейін салық міндеттемелерін бухгалтермен тексеріңіз.

Mythex-тегі жазылымдар

Mythex-те құрастырылған қолданбалар өз Stripe аккаунтын және кілттерін пайдаланады; қолданбаңыз үшін бір түймемен Stripe қосылымы жоқ. Тест кілттеріңізді және баға ID-лерін жоба құпиялары ретінде қосыңыз, жоғарыдағы сияқты промпттарды қолданыңыз және Preview-де Stripe-тың тест карталарымен сынаңыз. Webhook-терге қолданбаңыздың ашық URL-і керек, сондықтан endpoint-ті Stripe-та тіркеу алдында жариялаңыз, ал нақты кілттерге ауыстырғаннан кейін нақты қолданба жаңа кілттерді алуы үшін қайта жариялаңыз. Stripe арқылы төлем қабылдау және backend-те webhook өңдеу бөлімдерін қараңыз. Жазылымнан айналасында не құру керектігін білу үшін SaaS MVP қалай жасалады нұсқаулығын оқыңыз.

Сұрақтар