Fetch CIF by Masked Card Number
Retrieves the CIF (Customer Information File) number associated with a masked card number. The masked card number should follow the format where the first 6 and last 4 digits are visible and the middle digits are replaced with X characters. Returns a list of entity IDs since multiple customers could potentially be associated with the same masked card pattern.
Authorization
tenantAuth The DCMS tenant name for multi-tenant isolation. Every API call must include this header to identify the client organization.
In: header
Header Parameters
The DCMS client or tenant name for multi-tenant isolation.
Request Body
application/json
Masked card number in the format 123456XXXXXX6789 where the first 6 and last 4 digits are visible.
Response Body
application/json
application/json
curl -X POST "https://api.dcms.example.com/v1/fetchCifByMaskedCard" \ -H "tenant: ACME_BANK" \ -H "Content-Type: application/json" \ -d '{ "maskedCardNo": "123456XXXXXX6789" }'{
"result": {
"entityId": [
"210000000012"
]
},
"exception": null,
"pagination": null
}{
"result": null,
"exception": {
"errorCode": "MCC007",
"shortMessage": "valid kit not found",
"detailMessage": "No card found matching the provided masked card number",
"httpStatus": "BAD_REQUEST",
"fieldError": [
"Invalid masked card number format"
],
"languageCode": "en"
},
"pagination": null
}Fetch by CIF V2 POST
Enhanced version of the Fetch by CIF API with improved response structure and support for AES-GCM encryption for sensitive data. Provides the same functionality as v1 but with better structured responses, support for AES-GCM encryption for sensitive data fields, and improved error handling. Returns account information along with all associated cards and their current preference settings.
Fetch Kits by Account Number POST
Retrieves all card kits linked to a specific bank account number. Returns the account details along with all entities and their kits associated with that account. Supports an optional query parameter to include all cards including inactive and replaced ones.