m2pfintech
API LibraryCustomer

Update Nominee Details

Adds or updates the nominee details for a customer account. Nominees are individuals designated to receive account benefits in case of the account holder's demise.

Nominee Details

  • Name, relationship, DOB, age
  • Address and mobile number
  • Percentage share (must total 100% across all nominees)
  • Guardian details (required if nominee is a minor)
POST
/v1/customers/support/nominee/{entityId}

Authorization

bearerAuth tenantId
AuthorizationBearer <token>

JWT Bearer token from the Authentication API

In: header

X-TENANT-ID<token>

Your unique tenant identifier assigned during onboarding

In: header

Path Parameters

entityId*string

Customer entity ID

Header Parameters

X-TENANT-ID*string

Your unique tenant identifier

Request Body

application/json

nominees?
address?
age?integer
Formatint32
dateOfBirthInISOFormat?string
dob?string
guardian?object
minor?boolean
mobile?
percentShare?integer
Formatint32
relationship?string

Response Body

application/json

application/json

application/json

curl -X POST "https://sandbox-api.m2pprepaid.com/prepaid/customer/v1/customers/support/nominee/615928984620006085281025" \  -H "X-TENANT-ID: ACME_CORP" \  -H "Content-Type: application/json" \  -d '{    "nominees": [      {        "name": "John Doe",        "relationship": "Son",        "dob": "1990-01-01",        "age": 33,        "minor": false,        "address": {          "address1": "123 Main St",          "city": "Bangalore",          "state": "Karnataka",          "country": "India",          "pin": "560001"        },        "percentShare": 100,        "mobile": {          "value": "9876543210",          "countryCode": 91        }      }    ]  }'
{
  "result": {},
  "pagination": {
    "list": true,
    "pageSize": 0,
    "pageNo": 0,
    "totalPages": 0,
    "totalElements": 0
  }
}
{
  "type": "https://www.m2pfintech.com/problem/problem-with-message",
  "title": "Bad Request",
  "status": 400,
  "detail": "Unable to convert http message",
  "message": "error.http.400"
}
{
  "type": "https://www.m2pfintech.com/problem/problem-with-message",
  "title": "Invalid request",
  "status": 409,
  "detail": "Invalid request",
  "message": "error.business",
  "businessCode": "PPCUST_010"
}

Update Customer Profile POST

Updates customer profile details including personal information, address, communication preferences, and identity documents. ### Updatable Fields - **Personal**: firstName, lastName, gender, DOB, email - **Address**: permanentAddress, communicationAddress - **Identity**: PAN, nationalIdentity documents - **Banking**: cbsAccountNumber, CIF, customerId - **Risk**: riskRating, customerOccupation, politicallyExposed - **Custom**: customerAdditionalDetails (key-value metadata) ### Important Notes - `entityId` is required and identifies which customer to update - Only provided fields are updated — omitted fields remain unchanged - Status changes should use the dedicated Update Status endpoint

Update Customer Promocode POST

Adds, updates, or deletes a promo code for a customer. Promo codes control fee waivers, special rates, and promotional offers tied to a customer's card product. ### Actions | Action | Description | |--------|-------------| | `ADD` | Assign a new promo code | | `UPDATE` | Change to a different promo code | | `DELETE` | Remove the existing promo code | ### Validations - Promo code's product must match customer's product - Cannot delete if customer has no promo code