m2pfintech
API LibraryCustomer Management

Fetch by CIF V2

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.

POST
/v2/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/v2/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",
          "kitNo": "11024742",
          "domestic": {
            "isEnabled": false,
            "atm": {
              "dailyLimit": "150000",
              "isEnabled": false,
              "maxLimit": "150000"
            }
          },
          "international": {
            "isEnabled": false
          },
          "toggle": {
            "superOtp": false,
            "superPin": false,
            "locationShield": {
              "isEnabled": false
            },
            "swipeToPay": {
              "isEnabled": false
            }
          }
        }
      ]
    }
  },
  "exception": null,
  "pagination": null
}

Fetch by CIF POST

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.

Fetch CIF by Masked Card Number POST

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.