USSD - Documentation

Accept payments directly from your customers local bank account through ussd payment channel.
How it works
1.
To initiate a USSD payment, make a request to the USSD payments service with the payments/initiates endpoint.
2.
When the request is made you are expected to get a dial code.
3.
Customer completes transactions using the USSD spring and dial code generate
4.
​Verify the payment​
Authentication
Request
Response
1
curl -X POST
2
https://seerbitapi.com/api/v2/payments/initiates
3
-H 'Content-Type: application/json' 
4
-H 'Authorization: Bearer {token}
Copied!
1
{
2
    "publicKey":"SBTESTPUBK_PjQ5dFOi522L383MlsQYUMAe6cZYviTF",
3
    "amount":"100",
4
    "fullName": "Rasaq Agbalaya",
5
    "mobileNumber": "08087522256",
6
    "email":"[email protected]",
7
    "currency": "NGN",
8
    "country": "NG",
9
    "paymentReference": "dsffererer",
10
    "callbackUrl": "http://checkout-seerbit.surge.sh",
11
    "redirectUrl": "http://checkout-seerbit.surge.sh",
12
    "paymentType": "USSD",
13
    "bankCode":"044"
14
    }
15
​
Copied!
1
{
2
    "status": "SUCCESS",
3
    "data": {
4
        "code": null,
5
        "payments": {
6
            "paymentReference": "dsffererer",
7
            "linkingReference": "CSEERBIT724622561618580872054",
8
            "providerreference": "8206",
9
            "ussdDailCode": "*901*000*8206#"
10
        },
11
        "message": null
12
    }
13
}
Copied!

List Banks

Mobile Money

Last modified 5mo ago

Copy link