m2pfintech
API LibraryPre Issuance

Fetch TCS (Tax Collected at Source)

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.

POST
/v1/forex/issuance/wallet/fetch-tcs

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

Load amount in INR

productId*string

Product identifier

hierarchyId?string

Hierarchy/branch ID

Response Body

application/json

application/json

application/json

curl -X POST "https://sandbox-api.m2pprepaid.com/prepaid/corporate/v1/forex/issuance/wallet/fetch-tcs" \  -H "X-TENANT-ID: ACME_CORP" \  -H "Content-Type: application/json" \  -d '{    "pan": "ABCDE1234F",    "amount": 100000,    "productId": "FRX001",    "hierarchyId": "90009"  }'
{
  "result": {
    "tcsAmount": 0,
    "tcsPercentage": 0,
    "lrsUtilized": 50000,
    "lrsRemaining": 650000
  },
  "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": "Business validation failed",
  "status": 409,
  "detail": "Business validation failed",
  "message": "error.business",
  "businessCode": "PP_CORP_002"
}

Check Forex Issuance Limits POST

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.

Get Forex Conversion Rate for Issuance POST

Retrieves the currency conversion rate for use during forex card issuance. The rate includes product-level markups and any applicable promotional discounts. ### Response Fields - `conversionRate`: The effective rate applied to the transaction - `netAmount`: Total INR equivalent after applying the rate - `conversionGst`: GST on the currency conversion - `discountAmount`: Discount applied (if promotional rate active) ### Note Use this rate when populating the `walletAmount` array in the issuance request.