m2pfintech
API LibraryAccount Kit Mapping

Fetch Accounts by Card Number

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.

POST
/account/fetchAccountsByCardNo

Authorization

tenantAuth
tenant<token>

The DCMS tenant name for multi-tenant isolation. Every API call must include this header to identify the client organization.

In: header

Header Parameters

tenant*string

The DCMS client or tenant name for multi-tenant isolation.

Request Body

application/json

cardNumber?string

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/account/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
}

Testing & Migration

UAT environment, testing workflow, sandbox, and step-by-step migration guide from an existing card management system.

Fetch Accounts by Card Number (Mapping Manager) POST

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.