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

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.

Virtual Account and SoftPOS

Last modified 3mo ago