m2pfintech
API LibraryCard Preferences

Fetch Preference

Retrieves the current transaction preference settings for a specific card. Returns the complete preference state including domestic and international channel configurations, daily/monthly/yearly limits, dynamic authentication settings, location shield status, and swipe-to-pay configuration.

POST
/preference/fetch

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 entity identifier who owns the card.

kitNo*string

Kit number of the card whose preferences are being fetched.

Response Body

application/json

curl -X POST "https://api.dcms.example.com/v1/preference/fetch" \  -H "tenant: ACME_BANK" \  -H "Content-Type: application/json" \  -d '{    "entityId": "req7",    "kitNo": "4240171508"  }'
{
  "result": {
    "entityId": "req7",
    "kitNo": "4240171508",
    "domestic": {
      "isEnabled": true,
      "atm": {
        "isEnabled": false,
        "dailyLimit": "100000",
        "maxLimit": "100000",
        "monthlyLimit": "3000000",
        "yearlyLimit": "36000000"
      },
      "contactless": {
        "isEnabled": true,
        "dailyLimit": "1000",
        "maxLimit": "100000",
        "monthlyLimit": "150000",
        "yearlyLimit": "1800000"
      },
      "ecom": {
        "isEnabled": true,
        "dailyLimit": "5000",
        "maxLimit": "150000",
        "monthlyLimit": "3000000",
        "yearlyLimit": "36000000"
      },
      "pos": {
        "isEnabled": false,
        "dailyLimit": "20000",
        "maxLimit": "150000",
        "monthlyLimit": "3000000",
        "yearlyLimit": "36000000"
      },
      "recurringPayments": {
        "isEnabled": false
      },
      "tokenization": {
        "isEnabled": false,
        "dailyLimit": "100000",
        "maxLimit": "100000",
        "monthlyLimit": "3000000",
        "yearlyLimit": "36000000"
      }
    },
    "international": {
      "isEnabled": false
    },
    "dynamicAuth": {
      "otp": false,
      "pin": false
    },
    "locationShield": {
      "isEnabled": false
    },
    "swipeToPay": {
      "isEnabled": true,
      "dailyLimit": "10000",
      "maxLimit": "100000"
    }
  },
  "exception": null,
  "pagination": null
}

Fetch NCMC Preference POST

Retrieves the current NCMC preference settings for a specific card including auto-reload configuration, associated account number, and audit timestamps.

Process Opt-In POST

Processes a customer opt-in or opt-out preference for a specific operation. The operation is specified in the URL path parameter and represents the feature being opted in or out of. The optedIn field controls whether the customer is opting in (true) or opting out (false). Supports audit fields for tracking who made the change.