1. Home
  2. Scplite
  3. New Debit Card – New Account

New Debit Card – New Account

Endpoint: POST -> {host}/scplite/card/debit/new-account

Request Headers

NameKeyValue (Sample)TypeLength
Banck codeBankCode999number
Card’s encrypted Auth DataauthData…SASA22312=String
Issuer NumberissuerNr2string
User IduserIduser.namestring

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

NameKeyTypeLength
Name on cardnameOnCardString100
First namefirstNameString100
Last namelastNameString100
Account IDaccountIdString20
Account TypeaccountTypeNumeric2
Email AddressemailAddressString
Mobile numbermobileNrString
Street AddressstreetAddressString
Street Address Line 2streetAddressLine2String
CitycityString
StatestateString
Postal CodepostalCodeNumeric
Issuer NumberissuerNrNumeric
Currency CodecurrencyCodeNumeric3
Card ProgramcardProgramString
User IduserIdString

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 nameTypeDescription
Field#Field nameTypeDescription
1messageStringTextual representation of the response code
2panStringPAN
3seqNrNumericSequence numeric
4defaultAccountTypeNumericDefault Account Type
5expiryDateNumbericExpiry Date
6pinOffsetStringPin Offset
7cvvNumericCVV
8cvv2NumericCVV 2
9pinInfoStringPIN Info
10track2StringTrack 2
Was this article helpful to you? Yes No

How can we help?