Set card PIN
Sets or resets the PIN for the specified card.
Header Parameters
Tenant identifier. Required for all requests.
Request Body
application/json
Unique identifier of the entity (customer) requesting the PIN change.
Kit number of the card for which the PIN is being set or reset.
Card expiry date in YYYY-MM format, used for identity verification.
Date of birth of the cardholder in YYYY-MM-DD format, used for identity verification.
Current PIN of the card, required when changing an existing PIN.
New PIN to be set for the card.
Response Body
application/json
*/*
application/json
application/json
curl -X POST "https://api.m2pfintech.com/credit-line-management/business-entity-manager/setPin" \ -H "TENANT: string" \ -H "Content-Type: application/json" \ -d '{ "entityId": "E2EyUBCmdkpnkv5EB8", "kitNo": "180010188", "expiryDate": "2026-12", "dob": "1990-01-15", "pin": "1234" }'{
"result": {
"status": 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_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 POST
Initiates a card replacement for the specified entity, for example due to loss or damage.
Onboard a Corporate or Program entity POST
Creates a new business entity under the Corporate credit hierarchy. Set `entityType` to `CORPORATE` for company onboarding (`parentEntityId` = Tenant ID) or `PROGRAM` for a credit card programme (`parentEntityId` = Corporate entity ID). Billing configuration is required for PROGRAM entities.