View Card Data API

Request Method :: POST
Base URL: Will be shared later.
Endpoint: /ppcard/mw/card/view_card_data_by_cardrefnumber
Description: This API facilitates viewing card data (by providing the card reference number).

Headers

Content-Type: application/JSON
header_secrets: These values must be generated each time while consuming the API (refer to the generation process mentioned in the note above).
client_id:  To be shared during integration by ISU Team

Request Body Parameters

Parameters Parameter description with validations Sample Data type Mandatory/Optional
cardRefNo Card reference no.which belongs to this customer.
Length minimum - 10 and maximum - 12		 "1500000684" String Mandatory
type Type can be either`CUSTOMER` or `ADMIN`. If the type is `ADMIN`, the encrypted card number will be the masked card number in its encrypted form. Otherwise, it will be the normal encrypted card number. "CUSTOMER" String Mandatory
latLong Latitude and Longitude of the location from map "64:898" String Mandatory
deviceId Unique identifier of the device "1234567" String Mandatory(Optional where channel is WEB)
channel Channel should be WEB or ANDROID "ANDROID" String Mandatory

Sample Request Body

Response Body Parameters

Parameters Description Data type
status It can be either SUCCESS or FAILED String
statusCode 0 signifies SUCCESS 1 signifies FAILED Numeric
statusDesc Description of the status String
cardRefId Unique reference ID of the card Long
createdDate Date when the card was created String
lastModified Date when the card details were last modified String
lastfourDigit Last four digits of the card number String
productName Name of the product associated with the card String
productId ID of the product associated with the card Long
isActive Status indicating if the card is active Boolean
expiryDate Expiry date (encrypted using GCM algorithm) String
isBlock Status indicating if the card is blocked Boolean
isHotlist Status indicating if the card is hotlistedd Boolean
cardType Type of the card (MAGSTRIPE) String
encryptedCard Encrypted card details (GCM algorithm) String
nameOnCard Name printed on the card (encrypted using GCM algorithm) String
mobileNumber Encrypted mobile number (using GCM algorithm) String
cvv cvv (encrypted using GCM algorithm) String
isVirtual Indicates if the card is virtual Boolean
isPinSet Indicates if the PIN is set for the card Boolean
isDamage Indicates if the card is damaged Boolean
isLost Indicates if the card is lost Boolean
isStolen Indicates if the card is stolen String
productCategory Encrypted mobile number (using GCM algorithm) String
preferredLanguage Preferred language for communication String
atm_limit Per transaction ATM limit Doule
atm_max_limit Maximum ATM transaction limit Double
pos_limit Per transaction POS limit Double
pos_max_limit Maximum POS transaction limit Double
ecom_limit Per transaction e-commerce limit Double
ecom_max_limit Maximum e-commerce transaction limit Double
contactless_limit Per transaction contactless limit Double
contactless_max_limit Maximum contactless transaction limit Double
imps_limit Per transaction IMPS limit Double
imps_max_limit Maximum IMPS transaction limit Double
isEcomAllowed Indicates if e-commerce transactions are allowed Boolean
isContactlessAllowed Indicates if contactless transactions are allowed Boolean
isPosAllowed Indicates if POS transactions are allowed Boolean
isAtmAllowed Indicates if ATM transactions are allowed Boolean
isImpsAllowed Indicates if IMPS transactions are allowed Boolean
templateURL URL for the card template image String
networkType Type of network String
isReissue Indicates if the card is a reissue Boolean
isChild Indicates if the card is a child entity Boolean
mccDetails List of MCC details Array
mccCode Merchant Category Code Long
mccName Name of the Merchant Category String
applicable Indicates if the MCC is applicable Boolean
mccCategory Merchant category type String
mccCategoryCode Merchant category code String

Note:expiryDate, encryptedCard, mobileNumber, nameOnCard and cvv are encrypted by AES/GCM/NoPadding algorithm.

Sample Response Body

SUCCESS:

 

FAILED:

 

Detailed Status Codes

Status Response Type Description
0 SUCCESS Card details fetched successfully
1 FAILED Not authorized to view the data