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 |
Was this article helpful to you?
Yes
No