Skip to main content

Initiate Mobile Money Inflow

​
POST /v1/global-collection/mobile-money/initiate

Trigger a mobile money collection from your customer. This endpoint initiates an inflow request through the supported mobile money flow, prompting the customer to complete the payment on their end. 
curl --request POST \
  --url https://api.nomba.com/v1/global-collection/mobile-money/initiate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'accountId: <accountId>' \
  --data '{
    "phoneNumber": "0980802xxx",
    "pin": "0000",
    "callbackUrl": "https://your-server.com/webhook/collection",
    "amount": 10,
    "currency": "CDF",
    "topupVendor": "AIRTEL"
  }'

​
Request body

​
phoneNumber
string
required
The customer’s mobile money phone number.
​
pin
string
required
The customer’s mobile money PIN to authorize the collection.
​
callbackUrl
string
required
The URL Nomba will POST to when the transaction status changes. Must be publicly accessible.
​
amount
number
required
The amount to collect from the customer.
​
currency
string
required
ISO 4217 currency code for the collection (e.g., CDF).
​
topupVendor
string
required
The mobile money network provider (e.g., AIRTEL, MPESA).

​
Response body

​
transactionReference
string
required
Unique reference for this collection. Use this with Fetch Collection Transaction to check the status.
​
status
string
required
Initial status of the inflow request (e.g., PENDING).
​
message
string
A message describing the outcome.