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"
}