Tuitionable Tuitionable
Checkout & Payment Methods

Checkout & Payment Methods

How checkout works in Tuitionable: paying for a booking by gateway, wallet, or free first session, async webhook confirmation, and booking as a guest.

Payments & Wallet 7 min read Updated 16 Nov 2026
On this page

Overview

This page is for students who have drafted a booking and need to pay for it. It explains the tuitionable checkout flow end to end — the page you land on after picking a tutor, date, and time, and the three ways you can settle the amount due: a payment gateway (such as credit/debit card, PayNow, or PayPal), your wallet balance, or a free trial session that skips payment entirely.

It also covers what happens after you click pay: how Tuitionable confirms gateway payments asynchronously, and how you can start a booking as a guest without first creating a full account.

Checkout in Tuitionable is a two-stage flow. First you draft a booking (tutor, subject, slot, duration); then you land on a checkout page that holds the slot while you pay. You are never charged before you choose a payment method here.

There are two visual versions of the same checkout page, depending on where you started:

  • Public checkout — /checkout/{booking}, shown when you book from a public tutor profile.
  • Dashboard payment page — /student/payment/{booking}, shown when you book from inside your student dashboard.

Both accept the same booking and offer the same payment choices; only the layout and the page you return to after paying differ.

Reaching the checkout page

When you confirm a booking draft, Tuitionable reserves the slot and moves the booking into a pending_payment state, then sends you to checkout. The reservation gives you a short window to complete payment — the tutor will not be notified of your request until payment (or a wallet hold) is done.

What the checkout page shows

  • An order summary: the tutor, session type (single, package, or group), subject, duration, and your selected date and time.
  • The amount due, including any active promotional offer already applied to the price and any coupon discount you add.
  • A live status banner reflecting the booking and payment state (awaiting payment, processing, held, awaiting tutor confirmation, or confirmed).
  • A panel to edit the slot before you pay (see below).

Adjusting the slot before you pay

While a booking is unpaid, the public checkout page lets you change the date and time — and, for non-package bookings, the duration and subject — right from the order summary. This re-prices the booking to match, and the new slot is re-checked for availability before it is committed.

This in-checkout slot edit applies only to a booking that has not yet been paid. Once a booking is paid (or held), use Cancellations & Refunds instead — the student-initiated reschedule on a confirmed session is handled separately and may require your tutor's approval.

Abandoning a booking

If you decide not to pay, choose Cancel and go back. It will release the reserved slot, and mark the booking as cancelled. No charge is made.

Paying by gateway

To pay with a card or an online payment provider, use the gateway selector in the payment panel. It shows payment methods — for example, Airwallex, PayNow, bank transfer (wallet top-up), and others. Pick one and select Pay and confirm booking.

How a gateway payment flows

  1. Your selection submits to Payment Gateway with the booking and chosen gateway.
  2. Tuitionable creates a pending charge and asks the gateway to start the payment.
  3. Depending on the provider, the gateway either opens an inline overlay on the checkout page or redirects you to a hosted payment page.
  4. After you pay, the gateway returns you to /pay/callback/{gateway}, where Tuitionable verifies the result and lands you back on the right page with a success, pending, or error message.

If you start a payment and then use your browser's back button without completing it, the selector resets so you can pick a method and try again. No charge is made for an abandoned attempt.

Paying with your wallet

If you have funds in your Tuitionable wallet, the payment panel shows a Pay with wallet option with your current balance. When the balance covers the amount due, you can pay instantly without a gateway.

Held versus paid

Wallet payments are protected by an escrow-style hold. When you pay from your wallet, Tuitionable reserves the amount — moving it into a held state — rather than charging it outright. Your tutor is then notified of the request. The held funds are only captured (truly debited) once your tutor confirms the session. If the session is cancelled before confirmation, the hold is released back to your available balance.

Payment statusWhat it means for you
pending / unpaidAwaiting payment — nothing has been charged.
heldWallet funds reserved, awaiting tutor confirmation. Cancel before confirmation for a full refund back to your wallet.
paidPayment captured. The booking is locked and waiting on (or already has) tutor confirmation.
refundedThe amount was returned to your wallet (subject to the cancellation policy).

When your balance is short

If your wallet does not cover the amount due, the panel shows how much you are short and links you to top up. You can add funds on the wallet page and then return to pay, or use an alternative payment method for this booking instead.

Refunds in Tuitionable are returned to your wallet, regardless of how you originally paid — See Cancellations & Refunds for the policy that determines how refund works.

For how to add funds, view your ledger, and apply coupons, see Wallet, Coupons & Invoices.

Free first sessions

On a free booking, the checkout page replaces the payment widgets with a Confirm free session button. Selecting it sends your request straight to the tutor with no charge. The same applies to the dashboard payment page, which auto-confirms a zero-amount booking when you open it.

A free first session only applies to the first session (free) that a tutor provides. Once your trial booking is used, subsequent sessions are billed normally.

Coupons and offers

If you have a discount code, enter it in the Coupon field on the checkout page before choosing a payment method. The code is validated as you apply it, and the discount updates the displayed total amount payable so it matches whichever method you then use — wallet or gateway payment.

Tuitionable checks a coupon's eligibility when you apply it: whether it is active, within its valid date range, under its usage limits, above any minimum order, and applicable to bookings. If a code is ineligible, you will see the error message and the price stays unchanged. A promotional offer set by the tutor may already be reflected in the price before you add any coupon — the checkout page shows a "Promotion applied" badge when reflected.

Coupons apply to bookings and subscriptions, but not to wallet top-ups. For the full coupon and invoice reference, see Wallet, Coupons & Invoices.

Troubleshooting

SymptomWhat to do
"Opening secure checkout…" is stuck.Return to the page (back button or refresh). The selector resets so you can pick a method and retry. No charge is made for an incomplete attempt.
Payment shows as "processing" after I returned.This is normal — the confirming webhook may arrive a moment later. Wait briefly and refresh; the booking updates itself once confirmed.
"Wallet balance is too low."Top up your wallet for the shortfall shown, then return and pay from wallet — or choose a gateway for this booking instead.
A coupon code is rejected.The message states the reason (expired, usage limit reached, below minimum order, or not applicable). The price stays unchanged; try a different code or pay without one.
"This booking is already paid."The booking is settled. Open it from your bookings list to view its status, meeting details, and receipt.
I was charged but the booking still looks unpaid.Give the system a minute to land and refresh. If it does not update, contact support with your payment reference.
Skip to main content