m2pfintech
API LibraryUnknown

Replace Card

Initiates a card replacement request, optionally with a new kit, network type, and delivery address. Returns the replacement reference string.

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

Header Parameters

TENANT*string

Tenant identifier for multi-tenant routing

Request Body

application/json

entityId*string

Entity ID

plasticCode?string

Plastic code override

aliasName?string

Alias name for the card (masked)

fourthLine?string

Fourth line for card embossing

branchId?string

Branch ID (masked)

addressCategory?string

Address category enum

Value in"DELIVERY" | "COMMUNICATION" | "PERMANENT"
deliveryType?string

Delivery type enum

Value in"STANDARD" | "EXPRESS" | "BRANCH_PICKUP"
oldKitNo*string

Kit number of the card to be replaced

newKitNo?string

New kit number to assign

deliveryAddress?

Address information

cardReplaceReasonCode?string

Reason code enum for card replacement

Value in"LOST" | "STOLEN" | "DAMAGED" | "EXPIRED" | "UPGRADE" | "OTHER"
newNetworkType?string

New network type for the replacement card

isPhysicalPinRequired?boolean

Whether physical PIN mailer is required

validity?integer

Validity period for the new card

Formatint64
activeFrom?string

Date from which the new card is active (format yyyy-MM-dd)

Formatdate

Response Body

application/json

application/json

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": "CUST20260617001",    "oldKitNo": "180010188",    "deliveryType": "STANDARD",    "cardReplaceReasonCode": "DAMAGED",    "newNetworkType": "VISA",    "isPhysicalPinRequired": false,    "deliveryAddress": {      "addressCategory": "DELIVERY",      "address1": "42 MG Road",      "address2": "Apt 3B",      "city": "Bangalore",      "state": "Karnataka",      "country": "India",      "pinCode": "560001",      "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_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
}

Register Customer POST

Registers a new customer (individual or business entity) with credit info, KYC, kit info, address, communication, bank, and nominee details. Returns kit number, entity ID, and customer name fields.

Request Physical Card POST

Initiates a physical card request for a virtual card or new card issuance with optional delivery address.