Έγγραφα Rivya AI

Οδηγός πληρωμής και checkout στο Rivya

Κατανοήστε το checkout για πλάνα και πακέτα credits στο Rivya, τις ανακατευθύνσεις Stripe, τη γέφυρα /payment, τα webhooks, τις ενημερώσεις χρέωσης και τους ελέγχους αγοράς.

Τελευταίος έλεγχος στις 2026/04/28

Χρησιμοποιήστε αυτόν τον οδηγό πληρωμής και checkout όταν χρειάζεται να καταλάβετε τι συμβαίνει μετά την αγορά ενός πλάνου ή πακέτου credits στο Rivya.

Αυτό που συνήθως παρεξηγείται για τις πληρωμές στο Rivya είναι το εξής:

Το ότι το Stripe ολοκλήρωσε την πληρωμή δεν είναι το τελευταίο βήμα. Το προϊόν πρέπει ακόμη να συγχρονιστεί και να αποτυπώσει σωστά αυτή την αλλαγή.

Γι' αυτό η ροή checkout δεν τελειώνει στο Stripe και δεν τελειώνει τη στιγμή που επιστρέφει το πρόγραμμα περιήγησης.

Η ροή πληρωμής έχει τρία πραγματικά στάδια

Αυτή τη στιγμή, το checkout γίνεται πιο εύκολο να κατανοηθεί αν το χωρίσετε σε τρία στάδια:

  1. Το Rivya δημιουργεί το checkout session
  2. ο χρήστης ολοκληρώνει το Stripe Checkout
  3. το Rivya περιμένει να γίνει ξανά αξιόπιστη η κατάσταση προϊόντος

Αυτό το τρίτο στάδιο είναι ακριβώς ο λόγος που υπάρχει το /payment.

Από πού μπορεί να ξεκινήσει το checkout

Το checkout ξεκινά σήμερα από σημεία που ήδη ταιριάζουν στην πρόθεση του χρήστη:

Και τα δύο βασικά σχήματα αγοράς είναι:

  • checkout πλάνου συνδρομής
  • checkout εφάπαξ πακέτου credits

Αυτές είναι διαφορετικές εμπορικές αποφάσεις, αλλά εξακολουθούν να συγκλίνουν στην ίδια διαδρομή επιβεβαίωσης.

Το checkout πλάνου και το checkout πακέτου credits μοιάζουν, αλλά δεν είναι ίδια

Το checkout πλάνου έχει σχήμα συνδρομής.

Το checkout πακέτου credits έχει σχήμα εφάπαξ ανανέωσης wallet.

Αυτή η διαφορά έχει σημασία, επειδή μετά την πληρωμή το Rivya πρέπει να ξέρει αν πρέπει να ανανεώσει:

  • την κατάσταση συνδρομής
  • ή την κατάσταση wallet

Γι' αυτό η ίδια στιγμή επιτυχίας στο Stripe μπορεί ακόμη να σας στείλει πίσω σε διαφορετικές επιφάνειες προϊόντος μετά.

Γιατί υπάρχει καθόλου το /payment

Το /payment δεν είναι σελίδα απόδειξης με τη συνηθισμένη έννοια.

Είναι γέφυρα επεξεργασίας.

Η δουλειά του είναι να:

  • διαβάζει το Stripe session_id
  • ελέγχει αν η εγγραφή πληρωμής στην πλευρά προϊόντος έχει οριστικοποιηθεί
  • συνεχίζει να κάνει polling για σύντομο διάστημα αν χρειάζεται
  • μόνο τότε να σας ανακατευθύνει πίσω στο σωστό μέρος της εφαρμογής

Αυτό το κάνει περισσότερο σελίδα συγχρονισμού κατάστασης παρά σελίδα περιεχομένου.

Πότε είναι μια πληρωμή «πραγματικά ολοκληρωμένη» από την οπτική του προϊόντος;

Από την οπτική του χρήστη, η πληρωμή μοιάζει ολοκληρωμένη μόλις το Stripe πει ότι πέτυχε.

Από την οπτική του προϊόντος, η πληρωμή είναι πραγματικά ολοκληρωμένη μόνο όταν η κατάσταση λογαριασμού έχει ενημερωθεί ορατά στο Rivya.

Αυτό συνήθως σημαίνει:

  • η εγγραφή πληρωμής έχει επισημανθεί ως paid ή completed
  • τα αποτελέσματα στη συνδρομή ή στο wallet είναι ορατά
  • μπορείτε να επιστρέψετε με ασφάλεια στη χρέωση ή στα credits χωρίς να δείτε παλιά κατάσταση

Αυτός είναι ο πραγματικός λόγος που το προϊόν περιμένει στο /payment αντί να πετάξει αμέσως τον χρήστη πίσω στην εφαρμογή.

Γιατί τα webhooks εξακολουθούν να έχουν σημασία παρότι το /payment κάνει polling

Το /payment δεν αντικαθιστά τα Stripe webhooks.

Τα webhooks παραμένουν αυτά που ενημερώνουν την ανθεκτική κατάσταση backend.

Η σελίδα /payment υπάρχει ώστε η εμπειρία να μπορεί να περιμένει μέχρι αυτή η κατάσταση να αποτυπωθεί αρκετά καλά ώστε να είναι αξιόπιστη πριν την ανακατεύθυνση.

Αυτή είναι η διαφορά ανάμεσα σε:

  • «το Stripe επεξεργάστηκε κάτι»
  • και «το Rivya αποτυπώνει πλέον καθαρά αυτή την αλλαγή»

Πού πηγαίνετε μετά την πληρωμή

Η διαδρομή επιστροφής συνδέεται σκόπιμα με αυτό που άλλαξε.

Αν η αγορά σχετιζόταν με συνδρομή, γενικά επιστρέφετε προς τη χρέωση.

Αν η αγορά ήταν πακέτο credits, γενικά επιστρέφετε προς τα credits.

Αυτό δεν είναι διακοσμητική δρομολόγηση. Ταιριάζει στην ερώτηση που συνήθως έχουν οι χρήστες αμέσως μετά την πληρωμή:

  • ενημερώθηκε το πλάνο μου;
  • ή ενημερώθηκε το wallet μου;

Τι σημαίνει πραγματικά ένα timeout ή μια αποτυχία

Αν το /payment λήξει χρονικά ή αποτύχει, αυτό δεν σημαίνει αυτόματα ότι η ίδια η πληρωμή εξαφανίστηκε.

Πιο συχνά σημαίνει ένα από αυτά:

  • η εγγραφή πληρωμής στην πλευρά προϊόντος δεν έχει οριστικοποιηθεί ακόμη
  • η ανακατεύθυνση περιμένει κατάσταση που ακόμη συγχρονίζεται
  • η σελίδα λογαριασμού θα έδειχνε ακόμη παλιά κατάσταση αν ο χρήστης ανακατευθυνόταν υπερβολικά νωρίς

Γι' αυτό μια κατάσταση timeout είναι καλύτερη από μια ψεύτικη κατάσταση επιτυχίας. Λέει στον χρήστη ότι η επιβεβαίωση προϊόντος είναι το μέρος που παραμένει ημιτελές.

Ο καλύτερος τρόπος να ελέγξετε αν η πληρωμή καταγράφηκε πραγματικά

Μετά το checkout, η καθαρότερη διαδρομή επαλήθευσης είναι:

  1. αφήστε το /payment να ολοκληρώσει τη ροή του
  2. ελέγξτε το /settings/billing αν η αγορά ήταν πλάνο
  3. ελέγξτε το /settings/credits αν η αγορά ήταν πακέτο
  4. ελέγξτε το Κέντρο ειδοποιήσεων αν ο λογαριασμός εξακολουθεί να μοιάζει εκτός συγχρονισμού

Αυτό είναι συνήθως καλύτερο από το να ανανεώνετε τυχαίες σελίδες και να μαντεύετε.

Η πληρωμή γίνεται επίσης μνήμη λογαριασμού

Η πληρωμή δεν είναι μόνο ενέργεια checkout. Γίνεται επίσης μέρος του ιστορικού λογαριασμού μέσα από ανθεκτικά γεγονότα όπως:

  • έναρξη συνδρομής
  • ανανέωση συνδρομής
  • αποτυχία πληρωμής
  • προσθήκη πακέτου credits

Γι' αυτό οι ειδοποιήσεις έχουν σημασία και εδώ. Το κλείσιμο της καρτέλας Stripe δεν είναι το τέλος της ιστορίας του λογαριασμού.

Ένα καλύτερο νοητικό μοντέλο

Ο απλούστερος τρόπος να σκέφτεστε το checkout του Rivya είναι:

  • το Stripe χειρίζεται τη μετακίνηση χρημάτων
  • το /payment χειρίζεται την επανείσοδο στην πλευρά προϊόντος

Αν κρατήσετε αυτούς τους δύο ρόλους χωριστά, ολόκληρη η ροή γίνεται πιο εύκολη στην κατανόηση.

Διαβάστε στη συνέχεια

Λίστα ελέγχου κατάστασης checkout

Όταν μια αγορά μοιάζει ημιτελής ή μπερδεμένη, ελέγξτε:

  • Επιβεβαιώστε από πού ξεκίνησε το Checkout: δημόσια τιμολόγηση, ρυθμίσεις χρέωσης ή ρυθμίσεις credits.
  • Ελέγξτε αν το Stripe ολοκλήρωσε την πληρωμή και επέστρεψε τον χρήστη στο /payment.
  • Περιμένετε το Rivya να ανανεώσει συνδρομή, πακέτο, invoice και κατάσταση wallet πριν ξεκινήσετε άλλη πληρωμένη εργασία.
  • Χρησιμοποιήστε σελίδες χρέωσης για συνδρομές και σελίδες credits για πακέτα ή ιστορικό wallet.
  • Μην αντιμετωπίζετε μια ανακατεύθυνση προγράμματος περιήγησης ως απόδειξη ότι webhook και κατάσταση λογαριασμού έχουν ήδη οριστικοποιηθεί.

Επανέλεγχος πριν δοκιμάσετε ξανά την πληρωμή

Επανελέγξτε πριν δοκιμάσετε ξανά αν ο χρήστης βλέπει παλιό πλάνο, credits που λείπουν, διπλά παράθυρα Checkout, αποτυχημένη πληρωμή ή επιτυχημένη απόδειξη Stripe που δεν αποτυπώνεται ακόμη στο Rivya.

Πίνακας περιεχομένων