m2pfintech
API LibraryCard Preferences

Set Preference

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.

POST
/preference/set

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 set.

domestic*

Domestic transaction preference settings.

international*

International transaction preference settings.

dynamicAuth?

Dynamic authentication settings for enhanced security.

swipeToPay?

Swipe-to-pay feature configuration.

Response Body

application/json

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

Set NCMC Preference POST

Sets or updates NCMC (National Common Mobility Card) specific preferences for a card. Currently supports configuring the auto-reload feature which automatically loads the wallet when the balance falls below a specified threshold amount.

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.