Pay with Mobile Money

Accept payments via mobile money from customers

POST {{BASE_URL}}/partner/collection/mobile_money/

Parameter	Type	Description	Required
mob_step	string	This is the payment step. Some payment methods might require multiple steps but for this, it's just a step. And the default value will be direct	true
country_code	string	ISO 3166-1 alpha-2 code. Use this endpoint to get the list of supported countries.	true
pay_amount	string	The amount the customer is required to pay.	true
pay_currency	string	Currency code (ISO 4217)	true
holder_phone	string	Mobile money phone number of the customer who is paying in e164 format. Payment requests will be sent to this phone number by the telco.	true
holder_ip_address	string	IP Address of the customer who is paying	true
holder_device_tag	string	Name of the device used to post this request. It could be through laptop, phone-android/ios	true
customer_ref	string	The reference got from Create customer endpoint.	true
pay_ext_ref	string	Your unique reference. This can be used to fetch the payment details.	false
custom_data	dict	Your custom data that will be returned	false

HEADERS

{
     'Authorization': 'Bearer xhscIjHgpm2ZiPjzKos4ivl4GhyZp5',
      'Content-Type': 'application/json',
      'moni-signature': 'wed332eeddrdbdbdbdbvdvdvdvvsbsvsd'
 }

REQUESTS

{
   "pay_va_step":"direct",
   "country_code":"ZM",
   "pay_amount":"105.24",
   "pay_currency":"ZMW",
   "holder_phone":"[phone]",
   "holder_ip_address":"47.58.201.124",
   "holder_device_tag":"iphone",
   "customer_ref":"MC-DHEG123EHEH33H2H2",
   "pay_ext_ref":"12gddhetwdgedgdge",
   "custom_data":{"color":"blue","item_name":"radio"}
}

RESPONSE

CREATED 201

{
  "message": "Payment in progress",
  "payin_ref": "WMPay-rwmkq321mvxshjpscv7e8x3grbfxew",
  "payment_ext_reference": "12gddhetwdgedgdge",
  "status": true,
  "status_code": 201,
  "custom_data":{"color":"blue","item_name":"radio"},
}

BAD REQUEST 400

{
   "message": "Phone number is required",
   "status": false,
   "status_code": 400
}

TEST DATA

Currency - ZMW
Country code -  ZM
networks - mtn, airtel
phone_number = [phone] [mtn] , [phone][airtel]