How to debug a payment that didn't verify

Club Admin / Parent · Bahasa Melayu below

Sometimes a parent pays but the invoice stays unpaid. Common causes and fixes:

Parent-side troubleshoot

1. Check email — does the gateway (ToyyibPay / Billplz / Stripe) confirm the payment?
2. Check bank statement — did the money actually leave your account?
3. If no: the transaction failed at the gateway. Retry.
4. If yes but invoice still unpaid: something went wrong between the gateway and AAU Club Manager. Move to admin steps.

Admin: find the transaction in the gateway

1. Log into ToyyibPay / Billplz / Stripe dashboard
2. Search for the parent's email or the invoice number
3. Note the transaction status: - Success + Callback OK — AAU Club Manager should have updated. See "AAU Club Manager didn't process" below. - Success + No callback — the webhook failed. Manually record + verify in AAU Club Manager. - Failed — parent needs to retry - Pending — wait; some FPX transactions take up to 24h

Manually record a gateway payment

If the gateway shows success but AAU Club Manager still shows unpaid:

1. Sidebar → Billing → Invoices → open the invoice
2. Record Payment → fill in amount, method = Online Gateway, reference = the gateway transaction ID
3. Save
4. Immediately click Verify on the payment row

Invoice status flips to Paid.

Check webhook logs

Admin can verify AAU Club Manager is receiving webhooks: - Server logs — search for [Billplz Webhook], [ToyyibPay Webhook], or [Stripe Webhook] - If the gateway confirms sending but logs show nothing: AAU Club Manager's webhook URL may be wrong or blocked. Reconfigure in gateway dashboard.

Common webhook errors seen in logs

• Bad Request: /billing/webhook/billplz/ — gateway sent a request without invoice IDs (usually a test call)
• 401 Failed to fetch bill — API credentials are wrong; re-check keys in Club Settings → Billing → Payment methods
• Duplicate payment recorded — the same transaction fired twice; safe to ignore

Parent paid twice

If the parent paid the same invoice twice by mistake: - Cancel one payment → open Payments → find the duplicate → Delete - Refund from the gateway dashboard + record refund in AAU Club Manager (see Cancel or refund an invoice)

Cara debug bayaran tak diverify

Ibu bapa

1. Semak email gateway — pembayaran berjaya?
2. Semak statement bank — duit keluar?
3. Tidak keluar = gagal; cuba lagi
4. Keluar tapi invois masih belum bayar = admin action

Admin: cari dalam gateway

1. Login dashboard ToyyibPay / Billplz / Stripe
2. Cari transaksi dengan email / no. invois
3. Success + callback OK → AAU Club Manager harusnya update
4. Success + tiada callback → webhook gagal; rekod manual
5. Failed → parent retry
6. Pending → tunggu (FPX boleh sampai 24 jam)

Rekod manual

1. Billing → Invoices → buka
2. Record Payment — method Online Gateway, reference = transaction ID
3. Save → Verify

Semak webhook log

Server log: cari [Billplz Webhook], [ToyyibPay Webhook], [Stripe Webhook].

Error webhook biasa

• Bad Request — gateway hantar tanpa invoice ID (test call)
• 401 Failed to fetch bill — kredensial API salah
• Duplicate payment recorded — dua kali fire; abaikan

Ibu bapa bayar dua kali

Padam bayaran duplikat → refund dari gateway + rekod dalam AAU Club Manager.