Mobile Money

Mobile money is an e-wallet payment method in Africa which allows you to accept payments from your customers with their mobile money wallets.

Mobile money is currently available in Ghana, Kenya, Uganda, Tanzania, Senegal, Burkina Faso, Ivory Coast, Cameroon, Mali, Guinea Conakry.
How it works
To initiate a mobile money transaction, make a request to the mobile money service with the payments/initiates endpoint.
When the request is made you are expected to get a "Transaction in progress" response with a code INP from SeerBit.
Once the customer authorises the transaction from his mobile device, you will be notified via webhook with the final status of the transaction.
​Verify the payment ​
Ensure your business has been approved for Mobile Money transactions before carrying out Mobile Money Transactions
Test transactions cannot be perfomed when paying via MOMO
Authentication
Request Body
Response Body
Authentication
curl -X POST
https://seerbitapi.com/api/v2/payments/initiates
-H 'Content-Type: application/json' 
-H 'Authorization: Bearer {token}
Request Body
{   
    "fullName":"john doe",
	  "email":"[email protected]",
	  "mobileNumber":"08022343345",
	  "publicKey":"merchant_publicKey",
    "paymentReference": "MOMO657485653771987599QWEW1AT",
    "deviceType":"nokia 3310",
    "sourceIP":"1.0.1.0",
    "currency": "UGX",
    "productDescription": "snacks",
    "country": "UG",
    "fee": "1.00",
    "network":"MTN",
    "voucherCode":"",
    "amount": "10.01",
    "productId":"grocery",
    "paymentType":"MOMO"
}
Response Body
{
    "status": "SUCCESS",
    "data": {
        "code": "INP",
        "payments": {
            "paymentReference": "O67456S537798799QWEWAT0MPTYP",
            "linkingReference": "CF323190231596441884237"
        },
        "message": "Kindly Enter Otp"
    }
}
Field
Description
Type
​
publicKey
This is available after sign-up 
dash board -> settings -> api keys.
String 
Required
fullName
customer name
String 
Optional
amount
amount to be paid
String 
Required
fee
charge on transaction,  customer or merchant to bear
whom to bear this can be set on the dashboard by merchant
String 
Optional
mobileNumber
customer phone number
String 
Required
currency
Currency to perform transaction
String 
Required
country
Country the customer is performing transaction {GH, UG ...}
String 
Required
paymentReference
Unique payment reference/identifier, To be supplied by the Merchant
String 
Required
email
Customer email address
String 
Required
productId
Unique identification number of product, To be supplied by Merchant 
String
Optional
productDescription
Narration of the transaction
String
Optional
paymentType
This specifies the payment option used {MOMO}
String
Required
deviceType
Custumer's device
String
Optional
sourceIP
Customer IP Address
String
Optional
invoiceNumber
Unique identifier for invoice Transactions to the locate  branch payment was made 
String
Optional
network
telco to charge { AIRTEL, TIGO, VODAFONE, MTN }
String
Required
voucherCode
This code is provided when telco to charge is VODAFONE. To get this code, Dial *110# and select option 4 to generate code
String
Optional
message
Response message from SeerBit
​
​
code
Response code from SeerBit
​
​
linkingReference
SeerBit transaction unique identifier
​
​
Get available networks
Authentication
Response Body
Authentication
curl -X GET
https://seerbitapi.com/api/v2/networks
-H 'Content-Type: application/json' 
-H 'Authorization: Bearer {token}
Response Body
{
    “code”: “00",
    “message”: “Successful”,
    “networks”: [
        {
            “networks”: “MTN”,
            “uniqueKey”: “fa8adf2852a069a7258f”,
            “status”: “ACTIVE”,
            “createdAt”: “2020-07-14T08:50:02”,
            “updatedAt”: “2020-07-14T08:50:02”,
            “voucherCode”: false
        },
        {
            “networks”: “VODAFONE”,
            “uniqueKey”: “9986f369801e21b3df29",
            “status”: “ACTIVE”,
            “createdAt”: “2020-07-14T08:50:04",
            “updatedAt”: “2020-07-14T08:50:04",
            “voucherCode”: true
        },
        {
            “networks”: “AIRTEL”,
            “uniqueKey”: “a4003fe72de52779a982”,
            “status”: “ACTIVE”,
            “createdAt”: “2020-07-14T08:50:05”,
            “updatedAt”: “2020-07-14T08:50:05”,
            “voucherCode”: false
        },
        {
            “networks”: “TIGO”,
            “uniqueKey”: “3e50f363c12b6bb6e537",
            “status”: “ACTIVE”,
            “createdAt”: “2020-07-14T08:50:06",
            “updatedAt”: “2020-07-14T08:50:06",
            “voucherCode”: false
        }
    ]
}
How do you want to integrate?
Simple Checkout
/integration/simple-checkout
Standard Checkout
/integration/standard-checkout
Libraries
/libraries
E-commerce Checkout
/integration/e-commerce-checkout

USSD

Payment Features

Last updated 7 months ago

Field	Description	Type
publicKey	This is available after sign-up dash board -> settings -> api keys.	String	Required
fullName	customer name	String	Optional
amount	amount to be paid	String	Required
fee	charge on transaction, customer or merchant to bear whom to bear this can be set on the dashboard by merchant	String	Optional
mobileNumber	customer phone number	String	Required
currency	Currency to perform transaction	String	Required
country	Country the customer is performing transaction {GH, UG ...}	String	Required
paymentReference	Unique payment reference/identifier, To be supplied by the Merchant	String	Required
email	Customer email address	String	Required
productId	Unique identification number of product, To be supplied by Merchant	String	Optional
productDescription	Narration of the transaction	String	Optional
paymentType	This specifies the payment option used {MOMO}	String	Required
deviceType	Custumer's device	String	Optional
sourceIP	Customer IP Address	String	Optional
invoiceNumber	Unique identifier for invoice Transactions to the locate branch payment was made	String	Optional
network	telco to charge { AIRTEL, TIGO, VODAFONE, MTN }	String	Required
voucherCode	This code is provided when telco to charge is VODAFONE. To get this code, Dial *110# and select option 4 to generate code	String	Optional
message	Response message from SeerBit
code	Response code from SeerBit
linkingReference	SeerBit transaction unique identifier