Build with Nodal
The Nodal API lets your website or app take mobile money payments, run debit orders and pay people out — without building any of the payment plumbing yourself. MTN MoMo is live today; more wallets plug in behind the same API.
What you can build
| You want to… | Use |
|---|---|
| Let customers pay for an order on your website or app | Hosted checkout— send them to a Nodal payment page, get them back when they've paid. The easiest way to start. |
| Charge a customer's phone directly from your own screen | Direct collections — your server asks Nodal to prompt their phone. |
| Share a link people can pay on (fees, donations, invoices) | Payment links |
| Ask for the same amount every week, month or quarter, approved each time | Repeating requests — Nodal prompts the customer each period; no up-front approval. |
| Collect the same amount every week, month or quarter | Mandates — the customer approves once, Nodal debits on schedule. |
| Pay suppliers, staff or customers, or give money back | Payouts and refunds |
| Know the moment something happens | Webhooks — Nodal calls your server on every payment event. |
How it works
- You call the API from your server over HTTPS with an API key from the Nodal portal. Keys are secret — never put one in a web page or mobile app.
- Requests and responses are JSON. Amounts are strings in emalangeni (SZL), like
"250.00". - Money lands in your own MTN MoMo merchant wallet. Nodal never holds your money — it runs the payment, keeps the records and tells you what happened.
- Payouts and refunds always wait for a second person on your team to approve them in the portal before any money leaves.
Base URL
Every request goes to:
https://api.tfolanodal.com
Every call moves real money
There is no test mode yet. Test with small amounts (E1.00) on your own MTN MoMo number and refund yourself afterwards. Testing and going live shows how.