Before you start
You need a Maya Business / Maya Checkout merchant account. Sign up at mayabusiness.com — approval times vary depending on your business documents.Configuration steps
Get your API keys
Log in to your Maya merchant dashboard → Settings → API Keys. You’ll see:
- Public Key (sandbox or production)
- Secret Key (sandbox or production)
Enter the keys in AppointFlow
Open
/admin/settings/payments. Toggle Maya on, then paste your Public Key and Secret Key. Click Save.The secret key is encrypted at rest.Set up the webhook
In your Maya dashboard, set the webhook URL to:Subscribe to payment success and payment failure events. Copy the webhook secret Maya gives you and paste it back into AppointFlow’s payment settings.
Run a test payment
Set your booking policy to require payment, then book through your public page
using Maya sandbox test credentials (available in Maya’s developer docs).
Using PayMongo and Maya together
You can enable both PayMongo and Maya simultaneously. At checkout, customers will see both options and pick their preferred provider. This is a good way to maximize successful payments — if one provider is down, the other still works.Supported payment methods
Through Maya Checkout, customers can pay via:- Maya wallet
- Credit/Debit cards (Visa, Mastercard)
- Bank transfers (via Maya’s connected banks)
- QR Ph (QR code payments)
Fees
Maya charges per-transaction fees — see their pricing page. AppointFlow takes no payment fee.Troubleshooting
Same patterns as PayMongo troubleshooting:- Stuck on Pending Payment → webhook URL or secret is wrong.
- ‘Invalid signature’ error → webhook secret doesn’t match.
- Test payments rejected → mismatched sandbox vs. production keys.