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

  1. Your server calls Initialize Transaction with your sk_live_ secret key.
  2. Send the customer to authorization_url full-page redirect, or keep them on your site with inline embed (WaaguanPay.checkout({ embed: true }).
  3. The customer pays the amount shown on checkout via MoMo.
  4. When the charge is paid, confirm it with Verify and/or a signed webhook (charge.success).
  5. 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:

  • Payments: Authorization: Bearer sk_live_… (Connect)
  • SMS: Authorization: Bearer sk_sms_… (SMS)

Next steps