m2pfintech

Set card transaction preferences for an entity or kit

Configures transaction channel preferences (ATM, ECOM, POS, contactless, international, DCC), credit/cash limits, currency settings, and detailed rule configurations for an entity or a specific kit. Can also set per-transaction-type daily/weekly/monthly/quarterly/yearly limits. The controller is in credit-clms (CardConfigController).

POST
/Yappay/business-entity-manager/setPreferences

Header Parameters

TENANT*string

Tenant identifier for multi-tenancy routing

Request Body

application/json

entityId?string

Entity (account) ID for which preferences are set

kitNo?string

Kit number for card-level preference setting

corporate?string

Corporate identifier if applicable

amount?number

Credit limit amount to set

Formatdouble
cashLimit?number

Cash limit amount to set

Formatdouble
atm?boolean

Enable or disable ATM transactions

ecom?boolean

Enable or disable e-commerce transactions

pos?boolean

Enable or disable POS transactions

contactless?boolean

Enable or disable contactless transactions

contactlessWithPin?boolean

Enable or disable contactless with PIN transactions

isAllowed?boolean

Whether the preference change is an allow or disallow operation (default: true)

Defaulttrue
international?boolean

Enable or disable international transactions

dcc?boolean

Enable or disable DCC (Dynamic Currency Conversion)

currency?string

Currency code for preference

currencyCode?integer

Numeric currency code for preference

isLimitUpgrade?boolean

Whether this is a limit upgrade operation

isOverLimitAllowed?boolean

Whether spending over the limit is allowed

preferredLanguage?string

Preferred language code for the entity

transactionUsageType?string

Usage type context for preferences (default: DOMESTIC)

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

Whether to validate against parent rule credit limit (default: false)

Defaultfalse
allowedRuleConfig?

Rule configuration for transaction allowance or disallowance

disallowedRuleConfig?

Rule configuration for transaction allowance or disallowance

limitConfigs?

List of per-transaction-type limit configurations

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://uat-m2p-ccms.m2pfintech.com/Yappay/business-entity-manager/setPreferences" \  -H "TENANT: string" \  -H "Content-Type: application/json" \  -d '{}'
{
  "status": 200,
  "result": true,
  "message": "Success"
}
{
  "status": 400,
  "message": "Invalid request parameters",
  "timestamp": "2019-08-24T14:15:22Z"
}
{
  "status": 400,
  "message": "Invalid request parameters",
  "timestamp": "2019-08-24T14:15:22Z"
}
{
  "status": 400,
  "message": "Invalid request parameters",
  "timestamp": "2019-08-24T14:15:22Z"
}