Endpoint: POST -> {host}/scplite/cards/pins

Request Headers

Name	Key	Value (Sample)	Type	Length	Purpose (Use cases)
Card’s encrypted Auth Data	authData	…SASA22312=	String	–	AuthData Specification
Bank Code	BankCode	999	number	–	Submitted with the CMS API requests. CMS uses this value to query for the Card Programs value.
User Id	userId	user.name	string	–	This is submitted as part of the calls to Postman to identify the user making the call.
Issuer Number	issuerNr	2	string	–	Card issuer unique id.

Sample Request

{
"issuerNr":"2",
"seqNr":"001",
"customerId":"000",
"mobileNr":"08029161483",
"userId":"olasoji.joseph"
}

Request Body Description

Name	Key	Value	Type	Length
Card sequence number	sequenceNo	999	Numeric	3

Sample Response (Success)

{
"responseCode": "00",
"responseMessage": "Successful",
"systemResponseCode": "0",
"systemResponseMessage": null,
"pin": "1596",
"pinOffset": "6567",
"description": "Successful"
}

Sample Response (Failure)

{
"errors": [
{
"code": 57, //A postilion response code
"message": "PAN not found" //Interpretation of the postilion code
}
]   
}