m2pfintech
API LibraryCustomer Fetch

Fetch All Cards for Customer

Retrieves all cards (active, inactive, blocked) associated with a customer. Supports lookup by mobile number, kit number, entity ID, or issued-by hierarchy.

POST
/v1/customers/support/fetch-cards

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

mobile?
issuedBy?string

Hierarchy/branch that issued the card

kitNo?string

Card kit number to filter by

entityId?string

Customer entity ID

tenant?string

Tenant identifier

Response Body

application/json

application/json

application/json

curl -X POST "https://sandbox-api.m2pprepaid.com/prepaid/customer/v1/customers/support/fetch-cards" \  -H "X-TENANT-ID: ACME_CORP" \  -H "Content-Type: application/json" \  -d '{    "mobile": {      "value": "9876543210",      "countryCode": 91    }  }'
{
  "result": [
    {
      "kitNo": "320000001",
      "cardStatus": "ACTIVE",
      "cardType": "PHYSICAL",
      "productType": "GPR"
    },
    {
      "kitNo": "320000002",
      "cardStatus": "BLOCKED",
      "cardType": "VIRTUAL",
      "productType": "GPR"
    }
  ],
  "pagination": null
}
{
  "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"
}

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

Fetch All Dispute Reason Codes GET

Retrieves the complete list of dispute reason codes across all card networks. Use this endpoint to populate a reason code dropdown in your dispute filing UI. ### Response Returns a flat list of all active reason codes. Each reason code includes: - `id`: Internal identifier - `reasonCode`: The network-specific reason code (e.g., "13.1" for VISA) - `reasonCodeDesc`: Human-readable description of the dispute reason - `status`: Whether the reason code is currently active ### Tip If you need reason codes for a specific network only, use the `/v1/disputes/fetch-reason-codes/network/{id}` endpoint instead.