Waaguan Pay Documentation
Accept Mobile Money payments with a hosted checkout, a REST API, and webhooks — without asking customers for card details.
What is Waaguan Pay?
Waaguan Pay lets your business collect Mobile Money payments. You create a charge on your server, send the customer to hosted checkout (full-page redirect or inline embed), and we notify you when payment is confirmed. You get a webhook and can also verify the transaction via API.
How it works
- Your server calls Initialize Transaction with your
sk_live_secret key. - Send the customer to
authorization_url— full-page redirect, or keep them on your site with inline embed (WaaguanPay.checkout({ embed: true }). - The customer pays the amount shown on checkout via MoMo.
- When the charge is paid, confirm it with Verify and/or a signed webhook (
charge.success). - Fulfill only after server-side confirmation — never from the browser alone.
Also: SMS
Need OTP or any text message? Waaguan SMS is separate from payments — own sk_sms_ key, buy credits with MoMo, then send.
Base URL
All API requests are made to your Waaguan deployment origin, for example:
https://waaguan.com/api/v1
Authentication
Authenticate server-side requests with a secret key in the Authorization header:
Next steps
- Getting started — create your first charge in minutes
- Redirect checkout — simplest full-page flow
- Inline / embed — modal on your site (no full-page leave)
- Webhooks — receive
charge.successsecurely - SMS service — OTP, alerts, bulk