Fee collection and payments
Stripe
Online fee collection through Stripe Checkout, with signed webhook capture writing receipts against the student fee ledger.
Available, configured at deployment
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.
What it does not do
Worth reading before a procurement decision rather than after.
- 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
Including the questions where the answer is no.
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.
Everything else
Other integrations, and the ones we do not have
The hub lists what is available and names what is not.
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