m2pfintech
API LibraryCustomer Management

Fetch by CIF

Retrieves detailed customer information by CIF (Customer Information File) number. Returns account information along with all associated cards and their current preference settings including domestic and international transaction limits, channel toggles, and security features. Each card entry includes encrypted card number, expiry date, card status, and full preference configuration.

POST
/fetchByCif

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

entityId*string

Customer CIF number to look up.

Response Body

application/json

curl -X POST "https://api.dcms.example.com/v1/fetchByCif" \  -H "tenant: ACME_BANK" \  -H "Content-Type: application/json" \  -d '{    "entityId": "8765457"  }'
{
  "result": {
    "entityId": "8765457",
    "accountInfo": {
      "accountNo": "1001984217778",
      "accountType": null,
      "kitInfo": [
        {
          "aliasName": "karthikeyan",
          "cardCategory": "DEBIT",
          "cardIssuanceDate": "2023-11-14",
          "cardIssuanceType": "WELCOME_KIT",
          "cardStatus": "REPLACED",
          "cardType": "VIRTUAL",
          "encryptedCardNumber": "EqP2m+gahmSfzZD9Nb3XnSXd9B9hZ9+KBuDnL3qCaNw=",
          "expDate": "2030-09-30",
          "fourthLine": "10001",
          "kitNo": "11024742",
          "plasticCode": null,
          "domestic": {
            "isEnabled": false,
            "atm": {
              "dailyLimit": "150000",
              "isEnabled": false,
              "maxLimit": "150000"
            },
            "pos": {
              "dailyLimit": "300000",
              "isEnabled": false,
              "maxLimit": "300000"
            },
            "ecom": {
              "dailyLimit": "300000",
              "isEnabled": false,
              "maxLimit": "300000"
            },
            "contactless": {
              "dailyLimit": "5000",
              "isEnabled": false,
              "maxLimit": "5000"
            }
          },
          "international": {
            "isEnabled": false,
            "atm": {
              "dailyLimit": "150000",
              "isEnabled": false,
              "maxLimit": "150000"
            }
          },
          "toggle": {
            "superOtp": false,
            "superPin": false,
            "locationShield": {
              "isEnabled": false
            },
            "swipeToPay": {
              "isEnabled": false
            }
          }
        }
      ]
    }
  },
  "exception": null,
  "pagination": null
}

Set Preference POST

Sets or updates the transaction preferences for a specific card. Allows configuring domestic and international transaction controls including enabling or disabling specific channels (ATM, POS, e-commerce, contactless), setting daily and maximum transaction limits, dynamic authentication settings (OTP and PIN), and swipe-to-pay configuration. The response returns the complete updated preference state including system-calculated monthly and yearly limits.

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.