77builder77
Backend και SDK

Πληρωμές (b77.payments)

Δέξου εφάπαξ πληρωμές και συνδρομές στον δικό σου λογαριασμό Stripe ή Whop.

Η εφαρμογή σου μπορεί να δέχεται εφάπαξ πληρωμές και συνδρομές, που μπαίνουν απευθείας στον δικό σου λογαριασμό Stripe ή Whop. Το builder77 δεν κρατά καμία προμήθεια. Διαθέσιμο από το Starter και πάνω.

1. Σύνδεσε το Stripe ή το Whop

Στον builder άνοιξε Ρυθμίσεις → Πληρωμές (στις Ρυθμίσεις για προχωρημένους) και σύνδεσε έναν από τους δύο παρόχους ή και τους δύο. Τα κλειδιά αποθηκεύονται κρυπτογραφημένα.

  • Stripe: επικόλλησε το μυστικό κλειδί σου (Developers → API keys). Όσο κάνεις δοκιμές, χρησιμοποίησε κλειδί sk_test_….
  • Whop: στον πίνακα ελέγχου του Whop άνοιξε το Developer και δημιούργησε κλειδί API εταιρείας με δικαιώματα για πληρωμές, πλάνα, προϊόντα και checkout. Καταχώρισέ το μαζί με το ID της εταιρείας σου, που ξεκινά με biz_ και φαίνεται στη γραμμή διευθύνσεων του πίνακα ελέγχου. Ενεργοποίησε το Sandbox για να δοκιμάσεις πληρωμές χωρίς πραγματικά χρήματα.

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

2. Ξεκίνα μια πληρωμή

// b77.config.json: { "rules": { "classes": "readonly" } }
// a 'classes' record: { name: 'Yoga drop-in class', price: 15, currency: 'usd' }
await b77.payments.checkout({
  items: [{ collection: 'classes', id: classId, qty: 1 }], // the price is read on the server
  metadata: { note: 'Bring a mat' },
});
// or a price made at your provider:
// items: [{ price: 'price_123', qty: 1 }] (Stripe) / items: [{ price: 'plan_123' }] (Whop)

Οι τιμές διαβάζονται πάντα στον server, από μια εγγραφή σε συλλογή με τον κανόνα readonly (με name και price). Αντί για εγγραφή μπορείς να δώσεις ένα Stripe Price ID (price_…, μόνο για Stripe) ή ένα ID πλάνου Whop (plan_…, μόνο για Whop, ένα ανά πληρωμή).

Ο επισκέπτης μεταφέρεται στην ασφαλή σελίδα πληρωμής του παρόχου σου και μετά επιστρέφει στην ίδια οθόνη. Ή απλώς ζήτα από το builder77: «πρόσθεσε ένα κουμπί Αγορά που χρεώνει 15 $ ανά μάθημα».

3. Έλεγξε το αποτέλεσμα

const r = await b77.payments.result; // null | { canceled: true } | { paid, payment }
if (r?.paid) b77.toast('Payment received — see you in class!');

Συνδρομές

// b77.config.json: { "rules": { "plans": "readonly", "lessons": "members" } }
// a 'plans' record: { name: 'Pro', price: 9, currency: 'usd', interval: 'month' }
await b77.payments.subscribe({ items: [{ collection: 'plans', id: planId, qty: 1 }] });

const { active } = await b77.payments.subscription(); // show or hide paywall UI
await b77.payments.manage(); // Stripe billing portal or the buyer's Whop membership page

Οι συνδρομές λειτουργούν και με τους δύο παρόχους· ο αγοραστής πρέπει να είναι συνδεδεμένος. Το b77.payments.manage() ανοίγει την πύλη πελατών του Stripe ή τη σελίδα συνδρομής του αγοραστή στο Whop. Για να μένει το επί πληρωμή περιεχόμενο κλειδωμένο στον server, βάλε το σε συλλογή με τον κανόνα members ή members-private.

Εγγραφές πληρωμών

Κάθε πληρωμή αποθηκεύεται στη συλλογή payments της εφαρμογής σου με status (pending, paid, expired), amount, currency, items και metadata, και τη βλέπεις στην καρτέλα Δεδομένα. Κάθε πληρωμή χρησιμοποιεί 1 credit ενσωματώσεων.