API LibraryForex Issuance

Fetch Forex Issuance by ID

Retrieves the complete details of a forex issuance by its unique ID, including customer details, wallet loads, fee breakdown, trip information, and approval status.

Authorization

bearerAuth tenantId

AuthorizationBearer <token>

In: header

X-TENANT-ID<token>

In: header

Path Parameters

id*string

Forex issuance ID

Header Parameters

X-TENANT-ID*string

Your unique tenant identifier

Response Body

`application/json`

`application/json`

curl -X GET "https://sandbox-api.m2pprepaid.com/prepaid/corporate/v1/forex/issuance/FXI20260601001" \  -H "X-TENANT-ID: ACME_CORP"

{
  "result": {
    "id": "FXI20260601001",
    "applicationNumber": "APP-FX-2026-001",
    "currentStatus": "APPROVED",
    "kitNo": "320000541",
    "entityId": "476843769320000541160925",
    "mobile": {
      "value": "9876543210",
      "countryCode": 91
    },
    "walletAmount": [
      {
        "walletName": "USD",
        "amount": 500,
        "conversionRate": 84.95,
        "netAmount": 42475
      }
    ],
    "summary": {
      "fees": 250,
      "gst": 45,
      "tcs": 500,
      "total": 43395
    }
  },
  "pagination": null
}

{
  "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"
}

Create Forex Card Issuance POST

Creates a new forex card issuance request with initial currency load. This is the primary endpoint for issuing forex travel cards. ### Pre-Requisite Steps (must be completed before calling this API) 1. **De-Dupe Check** — Verify no duplicate PAN/mobile exists 2. **AML Match** — Clear the customer through AML screening 3. **Limit Check** — Validate LRS limits 4. **Fetch TCS** — Get the TCS amount 5. **Conversion Rate** — Get live forex rate for each currency 6. **Fee Summary** — Get itemized fees (from Forex Rates API) ### Key Fields - `beneficiaries`: Customer details including passport, address, KYC documents - `walletAmount`: Currency loads with conversion details from rate API - `summary`: Fee breakdown from the fee summary API - `trip`: Travel details (destination, dates, purpose) - `funding`: Source of funds (bank account details) - `declarations`: Regulatory declarations (FATCA, LRS, T&C) ### Compliance Documents - **Passport**: Mandatory for all forex issuances - **Visa**: Required for travel-related issuances - **Air Ticket**: Required for travel - **A2 Form**: RBI declaration form - **Purpose Proof**: Required for education/medical purpose

Fetch Forex Issuances by Status and Issuer GET

Retrieves a paginated list of forex issuances filtered by the issuing hierarchy ID and current status. Useful for operational dashboards and approval queues. ### Common Status Values | Status | Description | |--------|-------------| | `CREATED` | Pending maker-checker approval | | `APPROVED` | Approved and processed | | `REJECTED` | Rejected by checker | | `FAILED` | Processing failed after approval |