JAMB API

Jamb Public API

Before sending any request, ensure that:

Users must provide an email and a phone number to be used for vending.
Users must also provide all server IPs that will connect to this system which has to be allowed for vending by Payvantage.

Jamb Candidate Profile Request

post
{{baseUrl}}
/api2/merchant/profreq/
Jamb candidates profile request

Jamb Pin Request

post
{{baseUrl]}
/api2/merchant/airtimereq/
Jamb pin request

Jamb Pin Response

Sample Response
{
{
"airtimeResponse": {
"utransid": "234RRTERW1AS788PN4",
"auditid": "K21345666344455556",
"pinnos": "6988775",
"airtimeStatus": "Success"
"statusMessage": "Transaction Successful",
"hash": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
}

Parameters

Field
Required/Optional
Data Type
Description
utransid
Required
String
Unique transaction id as sent from vendor. Preferably not less than 16 characters and not more than 25 characters.
auditid
Required
String
Return ID generated from Payvantage. For audit purposes.
pinnos
Required
String
Pin number from JAMB
airtimeStatus
Required
String
This is status of the payment. ‘Success’ or ‘Failed’.
statusMessage
Optional
String
A description of the status.
hash
Required
String
SHA512 hash of all parameters in the order.