M2P Fintech API documentation

Header Parameters

TENANT*string

Tenant identifier. Required for all requests.

Request Body

application/json

entityId*string

Unique identifier of the entity (customer or program) requesting card replacement.

plasticCode?string

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

aliasName?string

Alias name to be embossed on the replacement card.

fourthLine?string

Fourth line text to be embossed on the card.

branchId?string

Branch identifier associated with the card issuance.

addressCategory?string

Category of the address to use for delivery.

Value in

"PERMANENT" | "DELIVERY" | "COMMUNICATION" | "NRERELATIVE" | "CORPORATE" | "REGISTERED_ADDRESS" | "BRANCH_ADDRESS" | "BILLING_ADDRESS" | "BULK"

deliveryType?string

Speed of card delivery.

Value in"RUSH" | "NORMAL" | "BULK"

oldKitNo*string

Kit number of the card being replaced.

newKitNo?string

Kit number to assign to the replacement card, if pre-assigned.

expiryDate?string

Validity duration for the replacement card in days (e.g. "365" for one year).

deliveryAddress?

cardReplaceReasonCode*string

Reason code indicating why the card is being replaced.

Value in

"LOST_OR_STOLEN" | "WEAR_AND_TEAR" | "SECURITY_CONCERNS" | "FRAUDULENT_ACTIVITY" | "EXPIRED" | "OTHERS" | "CARD_MALFUNCTION" | "CARD_UPGRADE_OR_DOWNGRADE" | "NAME_CHANGE"

newNetworkType?string

Card network for the replacement card (e.g. VISA, MASTERCARD).

isPhysicalPinRequired?boolean

Whether a physical PIN mailer should be dispatched for the replacement card.

validity?integer

Validity duration in days (integer form). Use expiryDate for string-based input.

Formatint64

activeFrom?string

Date and time from which the replacement card becomes active.

Formatdate-time

Response Body

`application/json`

`/`

`application/json`

curl -X POST "https://api.m2pfintech.com/credit-line-management/business-entity-manager/replaceCard" \  -H "TENANT: string" \  -H "Content-Type: application/json" \  -d '{    "entityId": "E2EyUBCmdkpnkv5EB8",    "oldKitNo": "180010188",    "deliveryType": "RUSH",    "cardReplaceReasonCode": "WEAR_AND_TEAR",    "expiryDate": "365",    "newNetworkType": "VISA",    "isPhysicalPinRequired": false,    "branchId": "12345678",    "deliveryAddress": {      "addressCategory": "DELIVERY",      "address1": "822 Dee Lakes",      "address2": "Apt. 786",      "address3": "Rosamond Court",      "city": "Zulacester",      "state": "Washington",      "country": "INDIA",      "pinCode": "491122",      "isoCountryCode": "356"    }  }'

{
  "result": "Card replacement initiated successfully.",
  "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_404",
    "shortMessage": "Not Found",
    "detailMessage": "No card or entity found for the provided entityId or kitNo."
  },
  "pagination": null
}

{
  "result": null,
  "exception": {
    "errorCode": "ERR_500",
    "shortMessage": "Internal Server Error",
    "detailMessage": "An unexpected error occurred. Please try again later."
  },
  "pagination": null
}

Replace card

Header Parameters

Request Body

Response Body

200application/json

400*/*

404application/json

500application/json

`application/json`

`/`

`application/json`

`application/json`