m2pfintech
API LibraryCard Preferences

Fetch NCMC Preference

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

POST
/ncmc/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.

kitNo*string

Kit number of the NCMC card.

Response Body

application/json

curl -X POST "https://api.dcms.example.com/v1/ncmc/preference/fetch" \  -H "tenant: ACME_BANK" \  -H "Content-Type: application/json" \  -d '{    "entityId": "ENTITY123",    "kitNo": "KIT001"  }'
{
  "result": {
    "entityId": "ENTITY123",
    "kitNo": "KIT001",
    "accountNo": "1234567890",
    "autoReload": {
      "enabled": true,
      "threshold": 100,
      "loadAmount": 500
    },
    "createdDate": "2024-01-15T10:30:00Z",
    "changedDate": "2024-01-15T14:45:00Z"
  },
  "exception": null,
  "pagination": null
}

Upload Card Order File POST

Uploads a card order file in TXT format for processing. The file will be validated, stored, and prepared for card order creation. Use this API before calling the card-order/withFile endpoint. The file is uploaded as multipart form data.

Fetch Preference POST

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.