Fee collection and payments
Stripe
Online fee collection through Stripe Checkout, with signed webhook capture writing receipts against the student fee ledger.
Available as part of agreed implementation scope
Stripe is the gateway most international schools reach for, and it works the same way as the other two: a Checkout Session is created for the instalment being paid, the family completes payment on Stripe, and the confirmed payment is written to the fee ledger.
The integration calls the Stripe REST API directly rather than bundling the SDK, which keeps the server dependency surface small. Confirmation arrives via the `checkout.session.completed` webhook with its signature verified before anything is recorded.
Currency is a deployment setting, so a school collecting in AED, GBP, or USD configures that once rather than per fee head.
How it works
- A Checkout Session is created server-side for the specific instalment, so the amount is never set by the browser.
- The publishable key is public by design; the secret key and webhook secret stay server-side environment variables.
- Webhook signature verification precedes any ledger write, and capture is idempotent.
- Failed webhook deliveries are held for retry rather than dropped.
Who configures it
Secret key, publishable key, webhook secret, and currency are deployment environment variables. The Fees settings area reports which gateway is active.
Implementation considerations
Confirm these details during implementation so the agreed integration scope is delivered predictably.
- Subscriptions and Stripe Billing are not used. Fee instalments are Schoolyi’s own schedule, charged individually.
- One merchant account per deployment rather than per school.
- Refunds are recorded in Schoolyi but initiated from the Stripe dashboard.
Related
Stripe: common questions
How this integration is planned, configured, and delivered as part of the agreed project scope.
Which currencies are supported?+
Whatever your Stripe account supports.
The currency is set once at deployment rather than per fee head, so a school collecting in a single currency has nothing further to configure.
Is card data ever handled by Schoolyi?+
No. Payment happens on Stripe Checkout, hosted by Stripe.
Schoolyi creates the session and receives the confirmation; card details never reach our servers.
Can we run Stripe and another gateway at the same time?+
A deployment runs one online gateway at a time, selected by configuration.
Counter payments, cash, cheque, bank transfer recorded by staff, run alongside whichever gateway is active.
API-first architecture
Connect Schoolyi to the rest of your digital ecosystem
Schoolyi's modular architecture makes it straightforward to add the services and workflows agreed during implementation.
Bring your stack to a walkthrough
Tell us what you already run and which handoffs cost your team time. That is a more useful conversation than a compatibility list.
Already using Schoolyi? Sign in