m2pfintech
API LibraryUnknown

Set Preferences

Sets transaction channel preferences, spending limits, and rule configurations for an entity or card (kitNo). Validates parent rule credit limit based on request flag.

POST
/credit-line-management/business-entity-manager/setPreferences

Header Parameters

TENANT*string

Tenant identifier for multi-tenant routing

Request Body

application/json

entityId*string

Entity ID for which preferences are being set

kitNo?string

Card kit number (optional, for card-level preferences)

corporate?string

Corporate identifier

amount?number

Credit limit amount

Formatdouble
cashLimit?number

Cash limit amount

Formatdouble
atm?boolean

Enable/disable ATM transactions

ecom?boolean

Enable/disable e-commerce transactions

pos?boolean

Enable/disable POS transactions

contactless?boolean

Enable/disable contactless transactions

contactlessWithPin?boolean

Enable/disable contactless with PIN transactions

isAllowed?boolean

Whether the preference is allowed (default true)

international?boolean

Enable/disable international transactions

dcc?boolean

Enable/disable DCC (Dynamic Currency Conversion)

currency?string

Currency code

currencyCode?integer

ISO currency code

isLimitUpgrade?boolean

Whether this is a limit upgrade

isOverLimitAllowed?boolean

Whether over-limit transactions are allowed

preferredLanguage?string

Preferred communication language

transactionUsageType?string

Transaction usage type enum

Value in"DOMESTIC" | "INTERNATIONAL"
validateParentRuleCreditLimit?boolean

Whether to validate parent entity rule credit limit (default false)

allowedRuleConfig?

Rule configuration for allowed or disallowed transactions

disallowedRuleConfig?

Rule configuration for allowed or disallowed transactions

limitConfigs?

List of per-transaction-type limit configurations

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://api.m2pfintech.com/credit-line-management/business-entity-manager/setPreferences" \  -H "TENANT: string" \  -H "Content-Type: application/json" \  -d '{    "entityId": "CUST20260617001",    "kitNo": "180010188",    "amount": 50000,    "cashLimit": 10000,    "atm": true,    "ecom": true,    "pos": true,    "contactless": true,    "international": false,    "transactionUsageType": "DOMESTIC"  }'
{
  "result": true,
  "exception": null,
  "pagination": null
}
{
  "result": null,
  "exception": {
    "errorCode": "ERR_400",
    "shortMessage": "Bad Request",
    "detailMessage": "Invalid or missing required fields in the request payload."
  },
  "pagination": null
}
{
  "result": null,
  "exception": {
    "errorCode": "ERR_401",
    "shortMessage": "Unauthorized",
    "detailMessage": "Missing or invalid TENANT header."
  },
  "pagination": null
}
{
  "result": null,
  "exception": {
    "errorCode": "ERR_500",
    "shortMessage": "Internal Server Error",
    "detailMessage": "An unexpected error occurred. Please try again later."
  },
  "pagination": null
}

Set Card PIN (Deprecated) POST

Sets the PIN for a card (deprecated; use v2/setPin). Accepts encrypted PIN along with entity and card details. Returns PIN set status.

Update Customer Entity V2 POST

Updates customer entity details (v2) including personal info, contact, email, KYC, address, date, bank, and nominee information. Returns a boolean success flag.