m2pfintech
API LibraryCard Controls

Request physical card

Submits a request to issue a physical card for the specified entity.

POST
/business-entity-manager/requestPhysicalCard

Header Parameters

TENANT*string

Tenant identifier. Required for all requests.

Request Body

application/json

entityId?string

Unique identifier of the entity requesting physical card issuance.

plasticCode?string

Plastic code identifying the card design or card type to be issued.

aliasName?string

Alias name to be embossed on the physical card.

fourthLine?string

Fourth line text to be embossed on the card, typically for corporate or department name.

branchId?string

Branch identifier associated with the card issuance request.

addressCategory?string

Category of the registered address to use for card delivery.

Value in"PERMANENT" | "DELIVERY" | "COMMUNICATION" | "NRERELATIVE" | "CORPORATE" | "REGISTERED_ADDRESS" | "BRANCH_ADDRESS" | "BILLING_ADDRESS" | "BULK"
deliveryType?string

Speed of card delivery — RUSH for expedited, NORMAL for standard, BULK for batch delivery.

Value in"RUSH" | "NORMAL" | "BULK"
kitNo?string

Pre-assigned kit number for the new physical card, if applicable.

addressDto?

Custom delivery address to use instead of the registered address category.

Response Body

application/json

*/*

application/json

application/json

curl -X POST "https://api.m2pfintech.com/credit-line-management/business-entity-manager/requestPhysicalCard" \  -H "TENANT: string" \  -H "Content-Type: application/json" \  -d '{    "entityId": "E2EyUBCmdkpnkv5EB8",    "plasticCode": "PL001",    "deliveryType": "NORMAL",    "addressCategory": "DELIVERY",    "branchId": "12345678"  }'
{
  "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_409",
    "shortMessage": "Conflict",
    "detailMessage": "A physical card request already exists for this entity."
  },
  "pagination": null
}
{
  "result": null,
  "exception": {
    "errorCode": "ERR_500",
    "shortMessage": "Internal Server Error",
    "detailMessage": "An unexpected error occurred. Please try again later."
  },
  "pagination": null
}

Search addresses by field and value POST

Partial-match search within address records of a specific entity. Provide the address `field` name to search on and a `value` for case-insensitive partial matching. All three fields (`entityId`, `field`, `value`) are required.

Block or lock a credit card POST

Blocks or locks a credit card for a given entity. Use flag `B` to block and `L` to lock the card. Optionally scope the action to a specific kit number.