m2pfintech
API LibraryPre Issuance

Check Forex Issuance Limits

Validates whether a proposed forex issuance or load is within the configured limits. Checks include:

  • LRS limit: Annual ₹7 lakh cap per PAN
  • Product limits: Per-transaction and daily limits configured for the product
  • Hierarchy limits: Branch or corporate-level caps

When to Use

Call before creating an issuance to ensure the transaction will not be rejected due to limit violations.

POST
/v1/forex/issuance/fetch/issuance/limit-check

Authorization

bearerAuth tenantId
AuthorizationBearer <token>

In: header

X-TENANT-ID<token>

In: header

Header Parameters

X-TENANT-ID*string

Your unique tenant identifier

Request Body

application/json

pan*string

Customer PAN number

amount*number

Proposed load amount in foreign currency

currencyCode*string

Target currency code

productId*string

Product ID

hierarchyId?string

Hierarchy ID

mobile?

Response Body

application/json

application/json

application/json

curl -X POST "https://sandbox-api.m2pprepaid.com/prepaid/corporate/v1/forex/issuance/fetch/issuance/limit-check" \  -H "X-TENANT-ID: ACME_CORP" \  -H "Content-Type: application/json" \  -d '{    "pan": "ABCDE1234F",    "amount": 500,    "currencyCode": "USD",    "productId": "FRX001",    "hierarchyId": "90009",    "mobile": {      "value": "9876543210",      "countryCode": 91    }  }'
{
  "result": {
    "eligible": true,
    "lrsUtilized": 50000,
    "lrsRemaining": 650000,
    "productLimitRemaining": 500000
  },
  "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": "LRS limit exceeded for the financial year",
  "status": 409,
  "detail": "LRS limit exceeded for the financial year",
  "message": "error.business",
  "businessCode": "PP_CORP_150"
}

AML Name Matching POST

Performs Anti-Money Laundering (AML) name screening against sanctions and watchlists. This is a **mandatory** pre-issuance check for all forex card issuances. ### How It Works - Submits the customer's name for fuzzy matching against global sanctions lists - Returns a match score and list of potential matches - A score below the configured threshold allows issuance to proceed - Matches above the threshold require manual review or rejection ### Response - `matched: false` → No AML hits, safe to proceed - `matched: true` → Potential match found, review required

Fetch TCS (Tax Collected at Source) POST

Calculates the TCS applicable for a forex wallet load based on the load amount, customer's PAN, and LRS utilization for the financial year. ### TCS Rules (India) - **Up to ₹7 lakh** (LRS limit): No TCS - **Above ₹7 lakh**: 20% TCS on the excess amount (with PAN) - **Without PAN**: Higher TCS rate applies ### Response Returns the computed TCS amount that must be included in the issuance/load request.