How to set up online payment (ToyyibPay / Billplz)
Club Admin · Bahasa Melayu below
AAU Club Manager supports three ways for parents to pay:
- Bank transfer — you show the account number; parent uploads their bank slip
- QR code — you upload a DuitNow / TnG QR; parent uploads their receipt
- Online gateway — parent pays directly by card / FPX / e-wallet, funds land in your gateway account. ToyyibPay and Billplz are supported.
You can enable any combination. Online gateway is optional but strongly recommended for busy clubs.
Where to configure
Sidebar → Billing → Settings (/billing/settings/)
Bank transfer (simplest)
- Toggle Enable bank transfer → on
- Fill in:
- Bank name (e.g.
Maybank) - Account name (e.g.Bees Football Club) - Account number - Payment instructions — any note you want parents to see (e.g.Include child's name in reference) - Save
QR payment (DuitNow / TnG)
- Toggle Enable QR payment → on
- Upload the QR image (PNG or JPG)
- Add instructions (e.g.
Scan with any Malaysian banking app) - Save
ToyyibPay (online gateway — recommended for MY clubs)
You need a ToyyibPay account first — sign up at https://toyyibpay.com/
- In ToyyibPay dashboard → Settings → Secret Key → copy your Secret Key.
- Create a Category in ToyyibPay dashboard → copy its Category Code.
- Back in AAU Club Manager → Billing → Settings → scroll to ToyyibPay:
- Toggle Enable ToyyibPay → on
- Paste Secret Key
- Paste Category Code
- Sandbox mode — keep on until you've tested with a small live payment; then turn off for production
- Payment channel —
2= both FPX and card (recommended) - Transaction fees — leave defaults unless ToyyibPay quoted you different rates - Save
Test flow: parent → invoice → Pay Now → gets redirected to ToyyibPay → pays → returns to AAU Club Manager with Paid status.
Billplz (alternative)
Similar setup. Get your API key and Collection ID from your Billplz dashboard.
- Toggle Enable Billplz → on
- Paste API key
- Paste Collection ID
- Paste X-Signature (from Billplz account → API settings)
- Sandbox mode — same rule as ToyyibPay
- Save
Card auto-pay with Billplz (recurring)
Turn on Card auto-pay in the Billplz section and save. It needs the X-Signature key.
- Parents see Card auto-pay → Set up auto-pay on My Invoices and authorise a credit or debit card on Billplz's page.
- Every new invoice of theirs is then charged to that card by the daily job, and they get the usual receipt.
- If a card is declined, the invoice stays unpaid and the parent pays it the normal way. Each invoice is tried once.
- Only invoices raised after the card was saved are charged. Partly paid invoices, and invoices with a bank-transfer slip waiting, are skipped.
- The transaction fee uses your Billplz card rate, and Who pays transaction fees? applies as usual.
- FPX and e-wallets cannot be charged automatically.
The settings page shows how many parents are on auto-pay.
Testing
- Log in as a parent (or use an incognito browser)
- Open an invoice → Pay Now
- Choose the gateway → complete the payment
- You should land back on AAU Club Manager with a green "Payment received" banner
- Check the admin Payments list — a verified payment should appear automatically
If nothing appears: check the webhook — under Billing → Settings there's usually a "Webhook URL" that must match what's registered in ToyyibPay/Billplz.
Cara setup pembayaran online (ToyyibPay / Billplz)
Untuk Admin Kelab
AAU Club Manager sokong tiga cara ibu bapa boleh bayar:
- Pindahan bank — anda tunjuk no. akaun; ibu bapa upload slip
- Kod QR — anda upload QR DuitNow / TnG; ibu bapa upload resit
- Gateway online — ibu bapa bayar terus (card / FPX / e-wallet). ToyyibPay dan Billplz disokong.
Di mana
Menu sisi → Billing → Settings (/billing/settings/)
Pindahan bank
- Toggle Enable bank transfer → on
- Isikan nama bank, nama akaun, no. akaun, arahan pembayaran
- Save
QR (DuitNow / TnG)
- Toggle Enable QR payment → on
- Upload gambar QR
- Tambah arahan
- Save
ToyyibPay (disyorkan untuk kelab MY)
Perlu akaun ToyyibPay dulu — daftar di https://toyyibpay.com/
- Dari dashboard ToyyibPay → dapatkan Secret Key dan Category Code
- Di AAU Club Manager → Billing → Settings → ToyyibPay:
- Toggle Enable ToyyibPay → on
- Tampal Secret Key dan Category Code
- Sandbox mode — biar on dulu untuk test
- Payment channel —
2(FPX + card) - Save
Billplz
Sama seperti ToyyibPay tapi guna API Key, Collection ID, dan X-Signature dari dashboard Billplz.
Card auto-pay (bayaran berulang): hidupkan Card auto-pay dalam bahagian Billplz (perlu X-Signature). Ibu bapa tekan Set up auto-pay di My Invoices dan benarkan kad di halaman Billplz. Setiap invois baru dicaj ke kad itu setiap hari dan resit dihantar. Jika kad ditolak, invois kekal belum bayar dan dibayar seperti biasa. FPX tidak boleh dicaj automatik.
Test
- Log masuk sebagai ibu bapa
- Buka invois → Pay Now
- Pilih gateway → lengkapkan bayaran
- Sepatutnya kembali ke AAU Club Manager dengan status Paid