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

  1. To initiate a mobile money transaction, make a request to the mobile money service with the payments/initiates endpoint.

  2. When the request is made you are expected to get a "Transaction in progress" response with a code INP from SeerBit.

  3. 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

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":"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"
}
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?