Fetch All Dispute Reason Codes
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 identifierreasonCode: The network-specific reason code (e.g., "13.1" for VISA)reasonCodeDesc: Human-readable description of the dispute reasonstatus: 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.
Authorization
bearerAuth tenantId JWT Bearer token from the Authentication API
In: header
Your unique tenant identifier assigned during onboarding
In: header
Header Parameters
Your unique tenant identifier
Response Body
application/json
application/json
curl -X GET "https://sandbox-api.m2pprepaid.com/prepaid/corporate/v1/disputes/fetch-reason-codes" \ -H "X-TENANT-ID: ACME_CORP"{
"result": [
{
"id": 6,
"reasonCode": "10.1",
"reasonCodeDesc": "EMV Liability Shift Counterfeit Fraud",
"status": true
},
{
"id": 40,
"reasonCode": "13.1",
"reasonCodeDesc": "Merchandise / Services Not Received",
"status": true
},
{
"id": 25,
"reasonCode": "12.6.1",
"reasonCodeDesc": "Duplicate Processing",
"status": true
},
{
"id": 45,
"reasonCode": "13.6",
"reasonCodeDesc": "Credit Not Processed",
"status": true
},
{
"id": 201,
"reasonCode": "1061",
"reasonCodeDesc": "Credit not processed for cancelled or returned goods and services",
"status": true
},
{
"id": 401,
"reasonCode": "01",
"reasonCodeDesc": "Account debited but cash not dispensed",
"status": true
},
{
"id": 507,
"reasonCode": "4837",
"reasonCodeDesc": "Fraudulent transaction - no cardholder authorization",
"status": true
}
],
"pagination": null
}{
"type": "https://www.m2pfintech.com/problem/problem-with-message",
"title": "Bad Request",
"status": 400,
"detail": "Missing required header: X-TENANT-ID",
"message": "error.http.400"
}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 Dispute Reason Codes by Network GET
Retrieves dispute reason codes filtered by a specific card network. Use this endpoint when you know the card network (VISA, RuPay, Mastercard, etc.) and want to show only the applicable reason codes. ### Network IDs | ID | Network | |----|---------| | 1 | VISA | | 2 | RuPay | | 3 | UPI | | 4 | NETC (FASTag) | | 5 | NFS (ATM) | | 6 | Mastercard |