m2pfintech
API LibraryIssuance

Check Card Application Status

Checks the overall status of a card issuance application. While the Card Delivery Tracking API focuses on physical delivery, this API provides the broader application status including KYC verification, card printing, and fulfillment stages.

Application Statuses

StatusDescription
INITIATEDApplication received and being processed
KYC_PENDINGWaiting for KYC verification
KYC_APPROVEDKYC verification completed successfully
CARD_PRINTINGPhysical card is being printed
READY_FOR_DISPATCHCard printed and ready to be shipped
DISPATCHEDCard has been handed over to courier/branch
DELIVEREDCard successfully delivered
ACTIVATEDCard has been activated by the cardholder
REJECTEDApplication was rejected
FAILEDProcessing failed — contact support
POST
/v1/card-application-status/search

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

Application search criteria

applicationNumber?string

Issuance application number

kitNo?string

Card kit number

mobile?string

Cardholder's registered mobile number (10 digits)

cardStatus?string
customerName?string
decision?string
embosseType?string
fromCreatedDate?string
Formatdate
fromLastModifiedDate?string
Formatdate
productName?string
toCreatedDate?string
Formatdate
toLastModifiedDate?string
Formatdate

Response Body

application/json

application/json

curl -X POST "https://sandbox-api.m2pprepaid.com/prepaid/corporate/v1/card-application-status/search" \  -H "X-TENANT-ID: ACME_CORP" \  -H "Content-Type: application/json" \  -d '{    "applicationNumber": "APP_2025_00001234"  }'
{
  "result": {
    "applicationNumber": "APP_2025_00001234",
    "kitNo": "910000031",
    "status": "DISPATCHED",
    "customerName": "Rajesh Kumar",
    "productName": "Forex Travel Card - USD",
    "appliedDate": "2025-01-15",
    "lastUpdated": "2025-01-20"
  },
  "pagination": null
}
{
  "type": "https://www.m2pfintech.com/problem/problem-with-message",
  "title": "No application found",
  "status": 409,
  "detail": "No application found for the given search criteria",
  "message": "error.business"
}

Approve/Reject Issuance in Bulk POST

In a bulk corporate issuance, selectively rejects specific beneficiaries by their mobile numbers. All other beneficiaries in the application are automatically approved. ### Use Case - Bulk corporate issuance with 100 beneficiaries - Compliance team identifies 5 that should be rejected - Call this endpoint with those 5 mobile numbers - The other 95 are auto-approved

Validate Pre-Issuance POST

Pre-validates whether a wallet issuance request is within configured limits (monthly and yearly) for both purchaser and beneficiary. ### When to Use Call this **before** creating the wallet issuance to check eligibility and provide real-time feedback to users about limit status. ### Checks Performed - Product-level issuance limits (monthly/yearly) - Issuer-level issuance limits - Purchaser-level limits (how many wallets can this purchaser buy) - Beneficiary-level limits (how many wallets can this person receive)