Fetch Accounts by Card Number (Mapping Manager)
Retrieves the account-to-kit mapping information for a given card number through the account-kit mapping manager. Returns the entity ID, kit number, and a list of all linked accounts with their details including account number, status, type, currency, branch, IFSC code, and whether the account is a default or primary account. Also returns offline wallet accounts if applicable.
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
Full card number (clear text) to look up linked accounts for.
Response Body
application/json
application/json
curl -X POST "https://api.dcms.example.com/v1/accountkitmapping-manager/fetchAccountsByCardNo" \ -H "tenant: ACME_BANK" \ -H "Content-Type: application/json" \ -d '{ "cardNumber": "6729600000077473" }'{
"result": {
"entityId": "10920111168",
"kitNo": "10026219",
"linkedAccounts": [
{
"accountNo": "231000012544",
"accountStatus": "ACTIVE",
"accountType": "SAVING",
"accountsCurrency": "INR",
"branchId": "10011",
"defaultAccount": true,
"ifscCode": "YESB0UNTY01",
"isPrimary": false,
"schemeCode": "1026"
},
{
"accountNo": "2505190754127",
"accountStatus": "ACTIVE",
"accountType": "OFFLINE",
"defaultAccount": false,
"isPrimary": false,
"product": "GLOBAL_OFFLINE_PRODUCT"
},
{
"accountNo": "2505190754175",
"accountStatus": "ACTIVE",
"accountType": "OFFLINE",
"defaultAccount": false,
"isPrimary": false,
"product": "GLOBAL_OFFLINE_STAGED_PRODUCT"
}
]
},
"exception": null,
"pagination": null
}{
"result": null,
"exception": {
"errorCode": "MCC007",
"shortMessage": "valid kit not found",
"detailMessage": "No kit found for the given card number",
"httpStatus": "BAD_REQUEST",
"fieldError": [
"Invalid card number"
],
"languageCode": "en"
},
"pagination": null
}Fetch Accounts by Card Number POST
Retrieves the account-to-kit mapping information for a given card number through the account service. Returns the same information as the mapping manager endpoint including entity ID, kit number, and all linked accounts with their complete details. This is an alternative endpoint that routes through the account service instead of the mapping manager.
Validate Card POST
Validates a card without requiring PIN authentication. This API verifies the card using the last six digits of the card number, expiry date, entity ID, and registered mobile number. Returns card status, kit number, and linked account information on successful validation. This is useful for scenarios where PIN is not available but card identity needs to be confirmed.