m2pfintech
API LibraryPre Issuance

Get Forex Conversion Rate for Issuance

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.

POST
/v1/forex/issuance/conversion-rate

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

product*string

Product ID

business*string

Corporate/hierarchy ID

amount*number

Amount in foreign currency

fundMode*string
Value in"LOAD" | "RELOAD" | "Refund"
rateSubType*string
Value in"BUY" | "SELL"
walletName*string

Target currency code

discountRate?number

Discount on rate (decimal, 0.05 = 5%)

Response Body

application/json

application/json

curl -X POST "https://sandbox-api.m2pprepaid.com/prepaid/corporate/v1/forex/issuance/conversion-rate" \  -H "X-TENANT-ID: ACME_CORP" \  -H "Content-Type: application/json" \  -d '{    "product": "FRX001",    "business": "90009",    "amount": 500,    "fundMode": "LOAD",    "rateSubType": "BUY",    "walletName": "USD",    "discountRate": 0  }'
{
  "result": {
    "conversionRate": 84.95,
    "netAmount": 42475,
    "conversionGst": 125,
    "discountAmount": 0,
    "baseConversionRate": 84.5,
    "baseConvertedAmount": 42250,
    "valueOfSupply": 42250
  },
  "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"
}

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.

Credit/Debit Prepaid Card POST

Loads (credits) or debits a GPR (General Purpose Reloadable) card holder's wallet. This is the primary API for managing card balances for GPR, Gift, and NCMC products. ### Supported Operations - **CREDIT**: Add funds to the cardholder's wallet - **DEBIT**: Remove funds from the cardholder's wallet (partial or full) ### Debit Types For debit operations, specify `debitTransactionType`: - `PARTIAL_DEBIT` — Withdraw a specific amount - `FULL_DEBIT` — Withdraw entire balance - `FULL_DEBIT_WITH_CLOSURE` — Withdraw entire balance and close the account ### Maker-Checker This API creates a load request that may go through maker-checker approval. The `currentStatus` in the response indicates the processing state: - `CREATED` → Pending approval - `APPROVED` → Processed successfully ### Key Fields - `hierarchyId`: The branch/corporate ID initiating the load - `kitNo`: The card kit number to be loaded - `wallet.accountId`: The specific wallet to credit - `product.productType`: GPR, Gift, or GPR+NCMC