Endpoint:
POST -> {host}/scplite/card/debit/new-account
Request Headers
Name | Key | Value (Sample) | Type | Length |
---|---|---|---|---|
Banck code | BankCode | 999 | number | – |
Card’s encrypted Auth Data | authData | …SASA22312= | String | – |
Issuer Number | issuerNr | 2 | string | – |
User Id | userId | user.name | string | – |
Sample Request
{
"issuerNr"
: "002",
"cardProgram"
: "VERVE_PREPAID",
"userId"
: "Alex",
"firstName"
: "Test",
"lastName"
: "Test1",
"nameOnCard"
: "TestTest1",
"accountId"
: "5050107591",
"accountType"
: "20",
"currencyCode"
: "566",
"mobileNr":"08032162793",
"emailAddress":"test.test1@amfb.com",
"streetAddress":"12 eiuoi",
"streetAddressLine2":"Delaware",
"city":"Lagos",
"state":"Lagos",
"postalCode":"23401",
"countryCode":"NGN"
}
Request Body Description
Name | Key | Type | Length |
---|---|---|---|
Name on card | nameOnCard | String | 100 |
First name | firstName | String | 100 |
Last name | lastName | String | 100 |
Account ID | accountId | String | 20 |
Account Type | accountType | Numeric | 2 |
Email Address | emailAddress | String | – |
Mobile number | mobileNr | String | – |
Street Address | streetAddress | String | – |
Street Address Line 2 | streetAddressLine2 | String | – |
City | city | String | – |
State | state | String | – |
Postal Code | postalCode | Numeric | – |
Issuer Number | issuerNr | Numeric | – |
Currency Code | currencyCode | Numeric | 3 |
Card Program | cardProgram | String | – |
User Id | userId | String | – |
Sample Response (Success)
{
"responseCode": "00",
"responseMessage": null,
"systemResponseCode": "0",
"systemResponseMessage": "Approved or completed successfully",
"card": {
"pan": "5060990580000509473",
"seqNr": "001",
"defaultAccountType": "20",
"expiryDate": "2704",
"pinOffset": "6417",
"cvv": "123",
"cvv2": "967",
"pinInfo": "6387FBB446A20AE4",
"track2": "5060990580000509473=2704601006417123"
},
"responseCodeDescription": null
}
Sample Response (Failure)
{
"errors": [
{
"code": 57, //A postilion response code
"message": "PAN not found"
//Interpretation of the postilion code
}
]
}
Response Body Description
Field# | Field name | Type | Description |
---|---|---|---|
Field# | Field name | Type | Description |
1 | message | String | Textual representation of the response code |
2 | pan | String | PAN |
3 | seqNr | Numeric | Sequence numeric |
4 | defaultAccountType | Numeric | Default Account Type |
5 | expiryDate | Numberic | Expiry Date |
6 | pinOffset | String | Pin Offset |
7 | cvv | Numeric | CVV |
8 | cvv2 | Numeric | CVV 2 |
9 | pinInfo | String | PIN Info |
10 | track2 | String | Track 2 |