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

Array of nominee objects to add or update

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 '[    {      "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": "9876543210"    }  ]'
{
  "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