Mobile money push

POST /api/v1/payment/intasend-xb-push/ sends a payment prompt to a mobile money wallet outside Kenya. The currency decides which country's rails are used. The mobile network is detected from the phone number, or you can set it with operator_code.

Activation

Mobile money push is enabled per account. Contact support to switch it on for your live account.

curl -X POST https://api.intasend.com/api/v1/payment/intasend-xb-push/ \
  -H "Authorization: Bearer $INTASEND_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 5000,
    "currency": "UGX",
    "country": "UG",
    "phone_number": "256771234567",
    "api_ref": "order-123",
    "first_name": "Okello",
    "email": "[email protected]"
  }'

Request

Field	Required	Description
`amount`	Yes	Amount in `currency`. It is rounded up to a whole unit. Max 5,000,000.
`currency`	Yes	`UGX`, `TZS`, `RWF`, `CDF`, `GHS`, `NGN`, `XOF`, `XAF`
`country`	Yes	ISO-2 country code. For `XOF` and `XAF` it picks the country (for example `SN` or `CI`).
`phone_number`	Yes	International format without `+`, for example `256771234567`
`operator_code`	No	Force a network. See operator codes. Recommended in Tanzania.
`api_ref`	No	Your reference
`first_name`, `last_name`, `email`	No	Customer details
`wallet_id`	No	Wallet in the same currency. Defaults to your settlement wallet.
`mobile_tarrif`	No	`BUSINESS-PAYS` or `CUSTOMER-PAYS`

The response has the same shape as M-Pesa STK Push, with provider: "INTASEND-XB-PUSH".

Supported currencies

Currency	Countries	Networks
`UGX`	Uganda	MTN, Airtel
`TZS`	Tanzania	Vodacom (M-Pesa), Airtel, Tigo/Yas, Halotel
`RWF`	Rwanda	MTN, Airtel
`CDF`	DR Congo	Vodacom, Airtel, Orange
`GHS`	Ghana	MTN, AirtelTigo, Vodafone/Telecel
`NGN`	Nigeria	Bank/NIBSS
`XOF`	Côte d'Ivoire, Senegal, Burkina Faso	Orange, MTN, Moov, Wave, Free
`XAF`	Cameroon	MTN, Orange

Per-country examples are on the Countries pages.

Request​

Supported currencies​

Request

Supported currencies