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
curl -X POST
https://seerbitapi.com/api/v2/payments/initiates
-H 'Content-Type: application/json' 
-H 'Authorization: Bearer {token}
{
    "publicKey":"SBTESTPUBK_PjQ5dFOi522L383MlsQYUMAe6cZYviTF",
    "amount":"100",
    "fullName": "Rasaq Agbalaya",
    "mobileNumber": "08087522256",
    "email":"[email protected]",
    "currency": "NGN",
    "country": "NG",
    "paymentReference": "dsffererer",
    "callbackUrl": "http://checkout-seerbit.surge.sh",
    "redirectUrl": "http://checkout-seerbit.surge.sh",
    "paymentType": "USSD",
    "bankCode":"044"
    }
​
{
    "status": "SUCCESS",
    "data": {
        "code": null,
        "payments": {
            "paymentReference": "dsffererer",
            "linkingReference": "CSEERBIT724622561618580872054",
            "providerreference": "8206",
            "ussdDailCode": "*901*000*8206#"
        },
        "message": null
    }
}

List Banks

Mobile Money

Last modified 1yr ago

Copy link