m2pfintech

Add Card

Adds a floater (additional) card — physical or virtual — to an existing credit account. Allocates an unallocated kit from CMS and updates card preferences.

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

Header Parameters

TENANT*string

Tenant identifier

Request Body

application/json

entityId*string

Entity/account ID to add the card to

kitNo?string

Specific kit number to assign (optional; random unallocated kit used if not provided)

cardType*string
Value in"P" | "V"
network?array<NetworkType>

List of card networks

business?string

Business identifier

expiryDate?string

Card expiry date

Formatdate
plasticCode?string

Plastic code for physical card customization

aliasName?string

Alias/emboss name on the card

fourthLine?string

Fourth line text on physical card

cardSequenceNumber?string

Card sequence number

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://api.m2pfintech.com/credit-line-management/business-entity-manager/addCard" \  -H "TENANT: string" \  -H "Content-Type: application/json" \  -d '{    "entityId": "CUST20260617001",    "cardType": "V",    "network": "VISA"  }'
{
  "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
}