Quick Actions
Initiate Mobile Money Inflow
Trigger a mobile money collection request from your customer.
Fetch Transaction
Check the status of an initiated mobile money collection.
Fetch Inflow Providers
List the mobile money providers available for DRC inflow to choose the right topupVendor.
DRC Checkout
Use hosted Checkout when you want Nomba to handle the payment page and method selection experience.
How it works
1
Initiate a mobile money inflow
Call the InitiateMobileMoneyInflow endpoint with the customerβs phone number, the amount, and a callback URL. This sends a payment prompt to the customer on their mobile money network.
2
Customer completes payment
The customer approves the payment on their end via their mobile money provider (e.g., M-Pesa, Airtel Money).
3
Receive webhook notification
Nomba sends a webhook event to your callback URL when the transaction status changes. Set up your webhook handler to process the result.
4
Verify the transaction
Use the FetchMobileMoneyTransaction endpoint with the returned transaction reference to confirm the final status of the collection.
Reading the outcome
A collection is initiated asPENDING and settles asynchronously, because the customer still has to
approve the charge on their phone. Two fields tell you where it stands.
gatewayMessage is the response from the customerβs mobile money network. gatewayCode says
what it means:
See Fetch Transaction for the
full field reference.