Πώς να προσθέσετε συνδρομές με Stripe: Πακέτα, δοκιμές, webhooks και αποτυχημένες πληρωμές
Για να προσθέσετε συνδρομές με Stripe, δημιουργήστε ένα προϊόν με επαναλαμβανόμενη τιμή στο Stripe Dashboard, στείλτε τους πελάτες στο Stripe Checkout σε λειτουργία συνδρομής από τον διακομιστή σας, και αφήστε ένα webhook να σας λέει πότε κάθε πληρωμή επιτυχαίνει, αποτυγχάνει, αλλάζει ή τελειώνει. Αποθηκεύστε την κατάσταση της συνδρομής στον χρήστη και δώστε πρόσβαση με βάση αυτήν, όχι με βάση τη σελίδα επιτυχίας. Προσθέστε ένα κουμπί Διαχείριση χρέωσης που ανοίγει τη φιλοξενούμενη πύλη πελάτη του Stripe, ώστε οι άνθρωποι να αλλάζουν κάρτα και πρόγραμμα και να ακυρώνουν, χωρίς να φτιάξετε εσείς αυτές τις οθόνες.
Αυτός ο οδηγός στηρίζεται στο πώς να προσθέσετε πληρωμές στην εφαρμογή σας, που καλύπτει το Checkout μίας φοράς, τη λειτουργία δοκιμής και την παραγωγή. Εδώ επικεντρωνόμαστε σε ό,τι διαφέρει στην επαναλαμβανόμενη χρέωση. Τα στοιχεία του Stripe προέρχονται από την τεκμηρίωση του Stripe, όπως ίσχυε τον Σεπτέμβριο του 2026.
Γιατί οι συνδρομές είναι δυσκολότερες από τις πληρωμές μίας φοράς
Μια πληρωμή μίας φοράς γίνεται ενώ ο πελάτης βρίσκεται στην εφαρμογή σας. Μια συνδρομή συνεχίζει αφού φύγει: ανανεώσεις κάθε μήνα, κάρτες που λήγουν, αναβαθμίσεις στη μέση του κύκλου, ακυρώσεις που ισχύουν στο τέλος της περιόδου. Η εφαρμογή σας μαθαίνει γι' αυτά μόνο μέσω webhooks. Τα περισσότερα σφάλματα συνδρομών προέρχονται από το ότι η πρώτη πληρωμή αντιμετωπίζεται ως όλη η ιστορία.
Οι επιλογές σας
| Προσέγγιση | Τι χτίζετε | Καλύτερη για |
|---|---|---|
| Payment Link με επαναλαμβανόμενη τιμή | Μόνο έναν σύνδεσμο | Δοκιμή ζήτησης· διαχείριση πρόσβασης με το χέρι |
| Checkout (λειτουργία συνδρομής) + πύλη πελάτη | Ένα τελικό σημείο διακομιστή, ένα webhook, ένα κουμπί χρέωσης | Τις περισσότερες εφαρμογές SaaS και συνδρομές μελών |
| API συνδρομών με δική σας φόρμα πληρωμής | Πολύ περισσότερα: UI πληρωμής, ταυτοποίηση, επαναλήψεις | Εφαρμογές με ασυνήθιστες ροές χρέωσης |
| Πάροχος merchant-of-record | Παρόμοιο με το Checkout | Πωλητές που θέλουν τον πάροχο να χειρίζεται τον φόρο πωλήσεων |
Για τις περισσότερες εφαρμογές, το Checkout μαζί με την πύλη πελάτη είναι η σωστή ισορροπία. Συγκρίνετε παρόχους στο Stripe vs Paddle vs Lemon Squeezy αν η διαχείριση φόρων σας απασχολεί.
Σχεδιάστε την τιμολόγησή σας στο Stripe πρώτα
Στο Stripe, ένα προϊόν είναι αυτό που πουλάτε («Pro plan») και μια τιμή είναι πώς το χρεώνετε («$20 τον μήνα», «$200 τον χρόνο»). Ένα προϊόν μπορεί να έχει πολλές τιμές. Αποφασίστε:
- Ποια επίπεδα προσφέρετε και τι ξεκλειδώνει το καθένα στην εφαρμογή σας
- Μηνιαία, ετήσια ή και τα δύο
- Αν προσφέρετε δοκιμή, και αν χρειάζεται κάρτα από την αρχή
Δημιουργήστε τα προϊόντα και τις τιμές σε λειτουργία δοκιμής και κρατήστε τα αναγνωριστικά τιμών· η εφαρμογή σας τα αναφέρει. Αν δεν έχετε ακόμη αποφασίσει την τιμολόγηση, διαβάστε το πώς να τιμολογήσετε ένα προϊόν SaaS και το freemium έναντι δωρεάν δοκιμής.
Ο κύκλος ζωής της συνδρομής που πρέπει να χειριστείτε
Η τεκμηρίωση συνδρομών του Stripe απαριθμεί τις καταστάσεις που μπορεί να έχει μια συνδρομή. Οι πιο σημαντικές για την πρόσβαση:
| Κατάσταση | Τι σημαίνει | Δίνετε πρόσβαση; |
|---|---|---|
trialing | Σε περίοδο δοκιμής | Ναι |
active | Σε καλή κατάσταση | Ναι |
incomplete | Η πρώτη πληρωμή δεν έχει ολοκληρωθεί ακόμη· το Stripe δίνει στον πελάτη 23 ώρες | Όχι |
incomplete_expired | Η πρώτη πληρωμή δεν επιτυχαίνει ποτέ | Όχι |
past_due | Η τελευταία πληρωμή απέτυχε ή δεν έγινε· μπορεί να ακολουθήσουν επαναλήψεις | Δική σας επιλογή· πολλές εφαρμογές δίνουν σύντομη περίοδο χάριτος |
unpaid | Οι επαναλήψεις τελείωσαν, τα τιμολόγια μένουν ανοιχτά, δεν γίνονται άλλες προσπάθειες | Όχι· η τεκμηρίωση του Stripe λέει να ανακληθεί η πρόσβαση |
canceled | Τελείωσε· δεν μπορεί να ξαναρχίσει | Όχι |
paused | Η δοκιμή τελείωσε χωρίς τρόπο πληρωμής και ορίστηκε σε παύση | Όχι |
Αποθηκεύστε την κατάσταση στην εγγραφή του χρήστη ή του λογαριασμού σας και βασίστε την πρόσβαση πάνω της. Ενημερώστε την κάθε φορά που φτάνει σχετικό webhook.
Τα γεγονότα webhook που πρέπει να χειριστείτε
| Γεγονός | Τι κάνει η εφαρμογή σας |
|---|---|
checkout.session.completed | Συνδέει τα νέα αναγνωριστικά πελάτη και συνδρομής του Stripe με τον χρήστη σας |
invoice.paid | Σημειώνει τη συνδρομή ως ενεργή και καταγράφει το νέο τέλος περιόδου |
invoice.payment_failed | Ενημερώνει τον χρήστη ότι απέτυχε η κάρτα του και συνδέει με την πύλη |
invoice.payment_action_required | Ζητά από τον χρήστη να ολοκληρώσει την επαλήθευση της κάρτας |
customer.subscription.updated | Ενημερώνει πρόγραμμα, κατάσταση και τυχόν προγραμματισμένη ακύρωση |
customer.subscription.deleted | Αφαιρεί την πληρωμένη πρόσβαση |
customer.subscription.trial_will_end | Υπενθυμίζει στον χρήστη πριν τελειώσει η δοκιμή· το Stripe το στέλνει τρεις ημέρες πριν |
Οι κανόνες χειριστή από την τεκμηρίωση webhook του Stripe ισχύουν ακόμη: επαληθεύστε την υπογραφή με το ακατέργαστο σώμα, επιστρέφετε 2xx γρήγορα, χειριστείτε διπλότυπα και εκτός σειράς γεγονότα, και περιμένετε επαναλήψεις. Ο οδηγός τι είναι ένα webhook εξηγεί την ιδέα, και ο οδηγός πληρωμών απαριθμεί τους κανόνες αναλυτικά.
Βήμα προς βήμα
- Δημιουργήστε προϊόντα και τιμές στη λειτουργία δοκιμής του Stripe.
- Προσθέστε μυστικά: το μυστικό κλειδί, τα αναγνωριστικά τιμών και αργότερα το μυστικό υπογραφής του webhook. Ποτέ στον κώδικα της μπροστινής πλευράς.
- Σελίδα τιμών: το κουμπί κάθε πλάνου καλεί τον διακομιστή σας, ο οποίος δημιουργεί συνεδρία Checkout σε λειτουργία συνδρομής για τον συνδεδεμένο χρήστη. Περάστε το ID του χρήστη ώστε το webhook να αντιστοιχίσει την πληρωμή στον λογαριασμό.
- Τελικό σημείο webhook: επαληθεύστε τις υπογραφές και χειριστείτε τα γεγονότα παραπάνω, ενημερώνοντας μία εγγραφή συνδρομής ανά χρήστη.
- Περιορίστε λειτουργίες με βάση την αποθηκευμένη κατάσταση και το πρόγραμμα, ελεγμένα στον διακομιστή σε κάθε προστατευμένη ενέργεια, όχι μόνο σε κουμπιά που κρύβονται.
- Πύλη πελάτη: ρυθμίστε την στο Stripe Dashboard (ποια πλάνα μπορούν να αλλάξουν οι πελάτες, αν μπορούν να ακυρώσουν), και μετά προσθέστε κουμπί Διαχείριση χρέωσης που δημιουργεί συνεδρία πύλης στον διακομιστή και ανακατευθύνει εκεί.
- Αποτυχημένες πληρωμές: στις ρυθμίσεις χρέωσης του Stripe, επιλέξτε τη συμπεριφορά επαναλήψεων και τι συμβαίνει μετά την τελευταία. Δείξτε banner στην εφαρμογή όσο η κατάσταση είναι past_due.
- Δοκιμάστε ολόκληρο τον κύκλο ζωής, μετά δημοσιεύστε και καταχωρίστε το ζωντανό webhook.
Προτροπές για τον δημιουργό εφαρμογών AI
Πρόσθεσε χρέωση συνδρομής με Stripe. Πλάνα: Starter (ID τιμής στο STRIPE_PRICE_STARTER) και Pro (STRIPE_PRICE_PRO). Η σελίδα τιμών δημιουργεί συνεδρία Checkout σε λειτουργία συνδρομής στον διακομιστή με το STRIPE_SECRET_KEY, με το ID του συνδεδεμένου χρήστη. Αποθήκευσε στον χρήστη το ID πελάτη Stripe, το 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. Κράτα τα αναγνωριστικά των γεγονότων που έχουν ήδη επεξεργαστεί, ώστε τα διπλότυπα να αγνοούνται. Ενημέρωσε την κατάσταση του χρήστη από το αντικείμενο της συνδρομής, όχι από τη σειρά με την οποία φτάνουν τα γεγονότα.
Περιόρισε τις λειτουργίες Pro στον διακομιστή: να επιτρέπονται μόνο όταν η κατάσταση είναι active ή trialing και το πλάνο είναι Pro. Δείξε banner «η πληρωμή απέτυχε, ενημέρωσε την κάρτα σου» όταν η κατάσταση είναι past_due. Πρόσθεσε κουμπί Διαχείριση χρέωσης που ανοίγει την πύλη πελάτη του Stripe για αυτόν τον χρήστη.
Αναβαθμίσεις, υποβαθμίσεις και αναλογισμός
Όταν ένας πελάτης αλλάζει πλάνο, η τεκμηρίωση του Stripe λέει ότι η αλλαγή συχνά δημιουργεί αναλογισμό (proration): η νέα τιμή εφαρμόζεται στο υπόλοιπο της τρέχουσας περιόδου χρέωσης. Μπορείτε να προβάλετε τους αναλογισμούς ή να τους απενεργοποιήσετε. Αν τα πλάνα έχουν το ίδιο διάστημα, οι ημερομηνίες χρέωσης μένουν ίδιες· η μετάβαση από μηνιαίο σε ετήσιο μετακινεί την ημερομηνία χρέωσης στη μέρα της αλλαγής. Το να αφήνετε τους πελάτες να αλλάζουν πλάνο στην πύλη σας γλιτώνει τη συγγραφή αυτής της λογικής, αλλά αποφασίστε στις ρυθμίσεις της πύλης ποιες αλλαγές επιτρέπονται.
Λίστα ελέγχου δοκιμών
Χρησιμοποιήστε τη λειτουργία δοκιμής του Stripe και δοκιμαστικές κάρτες, και περάστε από κάθε κατάσταση:
- Η νέα συνδρομή δίνει το σωστό πλάνο στον σωστό χρήστη
- Αν κλείσετε την καρτέλα αμέσως μετά την πληρωμή, η πρόσβαση εξακολουθεί να δίνεται (αποδεικνύει ότι λειτουργεί το webhook)
- Μια κάρτα που απορρίπτεται κατά την εγγραφή δεν δίνει τίποτα
- Μια αποτυχημένη ανανέωση βάζει τον λογαριασμό σε past_due και δείχνει το banner
- Η ενημέρωση της κάρτας στην πύλη επαναφέρει την κατάσταση active
- Αναβάθμιση και υποβάθμιση αλλάζουν σωστά τις λειτουργίες
- Η ακύρωση στο τέλος της περιόδου κρατά την πρόσβαση μέχρι την ημερομηνία λήξης και μετά την αφαιρεί
- Οι χρήστες σε δοκιμή έχουν πρόσβαση, λαμβάνουν την υπενθύμιση, και μετατρέπονται ή χάνουν την πρόσβαση σωστά
- Αν σταλεί το ίδιο γεγονός webhook δύο φορές, δεν αλλάζει τίποτα
Οι δοκιμαστικές ώρες (test clocks) του Stripe σας επιτρέπουν να προσομοιώσετε την πάροδο του χρόνου, ώστε να δοκιμάσετε ανανεώσεις χωρίς να περιμένετε έναν μήνα. Δείτε την τρέχουσα τεκμηρίωση δοκιμών του Stripe για το πώς χρησιμοποιούνται.
Συνηθισμένα λάθη
- Χορήγηση πρόσβασης στη σελίδα επιτυχίας. Οι πελάτες μπορεί να πληρώσουν και να μην φτάσουν ποτέ εκεί. Χρησιμοποιήστε το webhook.
- Χειρισμός μόνο της πρώτης πληρωμής. Οι ανανεώσεις, οι αποτυχίες και οι ακυρώσεις έρχονται αργότερα, ως γεγονότα.
- Έλεγχος κατάστασης πλάνου μόνο στην μπροστινή πλευρά. Οποιοσδήποτε μπορεί να καλέσει απευθείας το API σας.
- Ένας χρήστης, πολλές συνδρομές από λάθος. Ελέγξτε αν υπάρχει ήδη συνδρομή πριν δημιουργήσετε νέα συνεδρία Checkout, ή στείλτε τους υπάρχοντες πελάτες στην πύλη.
- Ανάκληση πρόσβασης στην πρώτη αποτυχημένη ανανέωση. Οι κάρτες αποτυγχάνουν για συνηθισμένους λόγους. Μια σύντομη περίοδος χάριτος με σαφές banner κρατά τους πελάτες.
- Ξεχασμένο ζωντανό webhook. Τα τελικά σημεία δοκιμής και παραγωγής έχουν διαφορετικά μυστικά υπογραφής.
- Αγνόηση φόρων και επιστροφών. Αποφασίστε την πολιτική επιστροφών και ελέγξτε τις φορολογικές σας υποχρεώσεις με λογιστή πριν την κυκλοφορία.
Συνδρομές στο Mythex
Οι εφαρμογές που χτίζετε στο Mythex χρησιμοποιούν τον δικό σας λογαριασμό και κλειδιά Stripe· δεν υπάρχει σύνδεση Stripe με ένα κλικ για την εφαρμογή σας. Προσθέστε τα κλειδιά δοκιμής και τα αναγνωριστικά τιμών σας ως μυστικά του έργου, χρησιμοποιήστε προτροπές σαν τις παραπάνω και δοκιμάστε με δοκιμαστικές κάρτες Stripe στο Preview. Τα webhooks χρειάζονται τη δημόσια διεύθυνση της εφαρμογής σας, οπότε δημοσιεύστε πριν καταχωρίσετε το τελικό σημείο στο Stripe, και δημοσιεύστε ξανά αφού περάσετε σε live κλειδιά ώστε η ζωντανή εφαρμογή να τα πάρει. Δείτε Αποδοχή πληρωμών με το Stripe και Χειρισμός webhooks στο backend σας. Για το ευρύτερο προϊόν, το πώς να φτιάξετε MVP SaaS καλύπτει τι να χτίσετε γύρω από τη χρέωση.
Ερωτήσεις
Ποιος είναι ο απλούστερος τρόπος για να προσθέσω συνδρομές με Stripe;
Δημιουργήστε ένα προϊόν με επαναλαμβανόμενη τιμή στο Stripe Dashboard, στείλτε τους πελάτες στο Stripe Checkout σε λειτουργία συνδρομής, χειριστείτε τα γεγονότα συνδρομής με webhook και συνδέστε ένα κουμπί Διαχείριση χρέωσης με την φιλοξενούμενη πύλη πελάτη του Stripe. Έτσι δεν χρειάζεται να φτιάξετε μόνοι σας φόρμες καρτών και οθόνες αλλαγής προγράμματος.
Ποια γεγονότα webhook του Stripe χρειάζομαι για συνδρομές;
Τουλάχιστον το checkout.session.completed για να συνδέσετε τη νέα συνδρομή με τον χρήστη σας, το invoice.paid για να επιβεβαιώσετε κάθε επιτυχημένη πληρωμή, το invoice.payment_failed για να προειδοποιήσετε για αποτυχημένες ανανεώσεις, και τα customer.subscription.updated και customer.subscription.deleted για να παρακολουθείτε αλλαγές προγράμματος και ακυρώσεις.
Τι γίνεται όταν αποτυγχάνει μια πληρωμή συνδρομής;
Σύμφωνα με την τεκμηρίωση του Stripe από τον Σεπτέμβριο του 2026, η συνδρομή συνήθως περνά στην κατάσταση past_due και το Stripe μπορεί να επαναλάβει την πληρωμή ανάλογα με τις ρυθμίσεις σας. Μετά την τελευταία επανάληψη, οι ρυθμίσεις του Dashboard αποφασίζουν αν η συνδρομή ακυρώνεται, σημειώνεται ως unpaid ή μένει past_due.
Μπορώ να προσφέρω δωρεάν δοκιμή χωρίς να ζητήσω κάρτα;
Ναι. Το Stripe υποστηρίζει δωρεάν δοκιμές, και η τεκμηρίωσή του περιγράφει την κατάσταση paused για δοκιμές που λήγουν χωρίς τρόπο πληρωμής, όταν έχει ρυθμιστεί έτσι. Η ζήτηση κάρτας από την αρχή συνήθως σημαίνει λιγότερες εγγραφές αλλά περισσότερους πληρωτές· δοκιμάστε τι ταιριάζει στο προϊόν σας.