Οδηγός ενσωμάτωσης Stripe Apps

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

Τι είναι τα Stripe Apps;

Τα Stripe Apps επεκτείνουν τον πίνακα ελέγχου του Stripe με προσαρμοσμένα στοιχεία διεπαφής και ενσωματώσεις backend. Επιτρέπουν σε προγραμματιστές τρίτων:

• Να προσθέτουν προσαρμοσμένες προβολές σε σελίδες του πίνακα ελέγχου Stripe (πελάτες, πληρωμές, τιμολόγια κ.λπ.)
• Να έχουν πρόσβαση σε δεδομένα Stripe μέσω οριοθετημένων δικαιωμάτων
• Να συγχρονίζουν δεδομένα ανάμεσα στο Stripe και σε εξωτερικές πλατφόρμες όπως το Brevo
• Να παρέχουν ροές εισαγωγής και διαμόρφωσης μέσα στον πίνακα ελέγχου

Στόχοι της ενσωμάτωσης Tajo + Brevo

Το Stripe App του Tajo συνδέει το Stripe με το Brevo για να προσφέρει:

• Γνώση πελατών: Συγχρονισμός των προφίλ πελατών Stripe, του ιστορικού πληρωμών και της αξίας ζωής στις επαφές Brevo
• Παρακολούθηση συμβάντων: Προώθηση των συμβάντων Stripe (πληρωμές, συνδρομές, επιστροφές χρημάτων) ως συναλλακτικά συμβάντα Brevo
• Αυτοματοποιημένες καμπάνιες: Ενεργοποίηση καμπανιών email, SMS και WhatsApp του Brevo με βάση τη δραστηριότητα στο Stripe
• Προγράμματα πιστότητας: Δημιουργία ροών εργασίας διακράτησης με δεδομένα αγορών Stripe συγχρονισμένα στο Brevo

Επισκόπηση αρχιτεκτονικής

Περιεχόμενα του οδηγού

Αυτή η τεκμηρίωση καλύπτει ολόκληρο τον κύκλο ζωής της δημιουργίας και της δημοσίευσης ενός Stripe App:

Ξεκινήστε

Διαμόρφωση και αναφορά

Δυνατότητες και ενσωμάτωση

Λειτουργία και ανάπτυξη

Προϋποθέσεις

Πριν δημιουργήσετε ένα Stripe App, βεβαιωθείτε ότι διαθέτετε:

1. Λογαριασμό Stripe: Έναν ενεργοποιημένο λογαριασμό Stripe (όχι περιορισμένο σε δοκιμαστική λειτουργία)
2. Stripe CLI: Εγκαταστήστε το Stripe CLI για τοπική ανάπτυξη και μεταφόρτωση εφαρμογών
3. Node.js: Έκδοση 16 ή νεότερη για την επέκταση διεπαφής της εφαρμογής
4. Πρόσβαση στην πλατφόρμα Tajo: Ενεργό λογαριασμό Tajo με διαμορφωμένα διαπιστευτήρια του API Brevo

Γρήγορη εκκίνηση

# Install Stripe CLI
brew install stripe/stripe-cli/stripe

# Login to your Stripe account
stripe login

# Create a new Stripe App project
stripe apps create tajo-brevo-integration

# Start local development
stripe apps start

Βασικές έννοιες

Μανιφέστο εφαρμογής

Κάθε Stripe App διαθέτει ένα μανιφέστο stripe-app.json που δηλώνει δικαιώματα, viewports και ρυθμίσεις. Δείτε την Αναφορά μανιφέστου εφαρμογής για το πλήρες σχήμα.

Επεκτάσεις διεπαφής

Τα Stripe Apps μπορούν να εμφανίζουν στοιχεία διεπαφής βασισμένα σε React σε συγκεκριμένα viewports του πίνακα ελέγχου. Η εργαλειοθήκη διεπαφής παρέχει έτοιμα στοιχεία που ταιριάζουν με το σύστημα σχεδίασης του πίνακα ελέγχου Stripe.

Δικαιώματα

Οι εφαρμογές πρέπει να δηλώνουν τους συγκεκριμένους πόρους του API Stripe στους οποίους χρειάζονται πρόσβαση. Οι χρήστες εγκρίνουν αυτά τα δικαιώματα κατά την εγκατάσταση. Δείτε την Αναφορά δικαιωμάτων.

Μυστικό υπογραφής

Κάθε εφαρμογή λαμβάνει ένα μυστικό υπογραφής για την επαλήθευση των υπογραφών εγκατάστασης και την ασφαλή επικοινωνία ανάμεσα στο backend σας και το Stripe.

Ροή εργασίας ανάπτυξης

1. Ορίστε το μανιφέστο σας με τα απαιτούμενα δικαιώματα και viewports
2. Δημιουργήστε την επέκταση διεπαφής με τη βιβλιοθήκη στοιχείων React του Stripe
3. Υλοποιήστε τα τελικά σημεία backend για συγχρονισμό δεδομένων με το Brevo μέσω του Tajo
4. Δοκιμάστε τοπικά με την εντολή stripe apps start
5. Μεταφορτώστε με την εντολή stripe apps upload
6. Υποβάλετε για έλεγχο μέσω του πίνακα ελέγχου Stripe
7. Δημοσιεύστε και παρακολουθήστε μέσω των αναλύσεων

Επόμενα βήματα

Ξεκινήστε με τον Οδηγό δημοσίευσης για να κατανοήσετε το σύνολο των απαιτήσεων και έπειτα μελετήστε τις τεχνικές αναφορές, ώστε να διαμορφώσετε το μανιφέστο και τα δικαιώματα της εφαρμογής σας.