Forex Operations Summary
Returns a dashboard summary of forex operations including total issuances, loads, and transaction volumes. Useful for operational reporting and management dashboards.
Authorization
bearerAuth tenantId In: header
In: header
Header Parameters
Your unique tenant identifier
Response Body
application/json
application/json
curl -X GET "https://sandbox-api.m2pprepaid.com/prepaid/corporate/v1/forex/summary" \ -H "X-TENANT-ID: ACME_CORP"{
"result": {},
"pagination": {}
}{
"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"
}Fetch and Update Forex Exchange Rates POST
Fetches the latest forex exchange rates from upstream rate providers and updates the platform's internal rate cache. Returns the current rates after refresh. ### When to Use - Periodic rate refresh (typically called by an internal scheduler) - Manual rate refresh when rates appear stale - Before a batch of issuances to ensure fresh rates
Upload Beneficiaries Bulk Issuance POST
Uploads one or more files (CSV / Excel) containing beneficiary data for a previously created bulk issuance. This is the recommended approach for **large batches (100+ records)** instead of embedding all beneficiaries in the JSON body of the create call. ### Typical Flow for Large Batches ``` 1. POST /v1/corporate-issuances/ → issuanceType: Bulk, beneficiaries: [] Response: applicationNumber + CREATED status 2. POST /file/upload/beneficiary/bulk-upload/{applicationNumber} → Upload CSV file with beneficiary rows Response: list of uploaded file references 3. POST /state-transition → APPROVED 4. GET /fetch-by-status/SUCCESS → poll for completion ``` ### CSV Format The file should have one beneficiary per row with columns matching the `CorporateBeneficiary` schema fields (mobile, firstName, lastName, email, etc.). Contact M2P support for the exact template. ### Server Use the **corporate** server URLs for this endpoint.