m2pfintech
API LibraryCustomer

Update Customer Trip Details

Adds or updates travel trip details for a forex customer. Trip information is required for forex card operations and regulatory compliance.

Trip Types

  • NEW — Adding a new trip
  • EXISTING — Updating an existing trip (provide trip id)

Trip Details Include

  • Destination country with ISO codes
  • Travel dates (start/end)
  • Purpose of travel (with RBI purpose codes)
  • Passport details (number, file number, issue/expiry dates)
  • Supporting documents
POST
/v1/customers/update-trips

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

Header Parameters

X-TENANT-ID*string

Your unique tenant identifier

Request Body

application/json

entityId*string

Required. Customer entity ID

Length1 <= length
customerId*string

Required. Customer ID

Length1 <= length
trip*

Travel trip details

Response Body

application/json

application/json

application/json

curl -X POST "https://sandbox-api.m2pprepaid.com/prepaid/customer/v1/customers/update-trips" \  -H "X-TENANT-ID: ACME_CORP" \  -H "Content-Type: application/json" \  -d '{    "entityId": "865589889690000029281025",    "customerId": "87001810808",    "trip": {      "country": {        "name": "Argentina",        "countryCodeIso": 32,        "threeDigitCountryCode": "ARG",        "twoDigitCountryCode": "AR",        "codeIsd": 54      },      "startDate": "10/04/2025",      "endDate": "22/04/2025",      "purposeOfTravel": {        "code": "S0301",        "purpose": "BUSINESS"      },      "type": "EXISTING",      "passports": [        {          "passportNumber": "V7656550",          "passportFileNumber": "VPF093842342456",          "issuedPlace": "Chennai",          "issuedDate": "01/02/2020",          "expiryDate": "01/02/2030"        }      ]    }  }'
{
  "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": "Customer does not exists for id",
  "status": 409,
  "detail": "Customer does not exists for id",
  "message": "error.business",
  "businessCode": "PPCUST_002"
}

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

Upgrade Customer KYC POST

Upgrades a customer's card KYC level from **Min KYC** to **Full KYC**. This is required to increase transaction limits and enable full card functionality. ### Supported Document Types | Type | Description | |------|-------------| | `PAN` | Permanent Account Number | | `AADHAR` | Aadhaar card | | `PASSPORT` | Passport | | `DRIVING_LICENCE` | Driving licence | | `VOTER_ID` | Voter ID card | ### First-Time Registration For customers being registered for the first time during KYC upgrade, provide the `firstTimeRegistration` object with name, gender, email, and card details. ### Prerequisites - Customer must be in Min KYC status - Valid identity document is required