Phone USSD Verification - NG

The fastest and most secure way to verify mobile numbers using USSD instead of SMS OTPs. This endpoint is currently only available for businesses with customers in Nigeria.

POST {{BASE_URL}}/partner/verification/phone_ussd/

Parameter	Type	Description	Required
holder_phone	string	The phone number of the customer and it should be in e164 format.	true

HEADERS

{
     'Authorization': 'Bearer xhscIjHgpm2ZiPjzKos4ivl4GhyZp5',
      'Content-Type': 'application/json',
      'moni-signature': 'wed332eeddrdbdbdbdbvdvdvdvvsbsvsd'
 }

REQUEST

{
  "holder_phone":"[phone]"
}

RESPONSE

CREATED - 201

The ussd_code should be shown to the customer and he/she needs to dial the code in order to get verified.

{
        "message": "Verification Details",
        "mobile_operator": "glo",
        "status": true,
        "status_code": 201,
        "ussd_code": "*347*7070*919134#",
        "verification_reference": "VF-jtzkqr6s7kqjewxhyvc9",
        "verification_status": "on_going"
 }

BAD REQUEST - 400

{
   "message": "Verification service needs to be enabled by the merchant via merchant dashboard",
   "status": false,
   "status_code": 400
 }