Mobile money is currently available in Ghana, Kenya, Uganda, Tanzania, Senegal, Burkina Faso, Ivory Coast, Cameroon, Mali, Guinea Conakry.
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.
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
curl -X POSThttps://seerbitapi.com/api/v2/payments/initiates-H 'Content-Type: application/json'-H 'Authorization: Bearer {token}
{"fullName":"john doe","email":"johndoe@gmail.com","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"}
{"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 |
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 | | |
curl -X GEThttps://seerbitapi.com/api/v2/networks-H 'Content-Type: application/json'-H 'Authorization: Bearer {token}
{“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}]}