Fetch Multiple Cards by Issuer Number
This API handles requests to fetch cards by issuer number (required), PAN, first name, last name or card program. Multiple cards maybe returned but with a limit of 100 cards in the response.
Request Message description
Field # | Field name | Data type | Max length | Required | Description |
---|---|---|---|---|---|
1 | issuerNr | int | 3 | true | Issuer Number e.g 2 |
2 | cardProgram | string | 1 to 20 | true | Card Program e.g VERVE |
3 | lastName | string | 30 | false/true | Required for New Debit and Prepaid Cards |
4 | firstName | string | 30 | false/true | Required for New Debit and Prepaid Cards |
5 | pan | string | 16 to 19 | false/true | Required for Reissue Debit and Prepaid Cards |
POST /card-management/api/v1/card/fetchMultiple
Authorization = Bearer Token
Sample Request
{
"issuerNr": 2,
"pan": "5061800000000000363",
"firstName": "Test",
"lastName": "Test",
"cardProgram": "VERVE"
}
Response Message field description
Field # | Field name | Description |
---|---|---|
1 | code | Internal Response Code |
2 | description | Successful or Error Message |
3 | cardDetails | List of Card Details |
4 | errors | Errors array if any errors exists. |
Sample Response (success)
{
"code": "00",
"description": "Successful",
"cardDetails": [
{
"pan": "5060990000000056128",
"expiryDate": "5004",
"issuerNr": "2",
"firstName": "Test",
"lastName": "Test",
"nameOnCard": "Test",
"cardProgram": "VERVE",
"customerId": "1234567867",
"cardStatus": "0",
"seqNr": "001",
"streetAddress": "OKO AWO",
"city": "Lagos"
}
]
}
Sample Response (failure)
{
"error": "unauthorized",
"error_description": "Full authentication is required to access this resource"
}
Updated 7 months ago