m2pfintech
API LibraryIssuance

Fetch Issuances by Status

Returns a paginated list of all corporate issuances in a specific status. This is the primary status-tracking endpoint for the partner portal — poll this after triggering a bulk issuance to check how many records have moved to SUCCESS or FAILED.

Valid Status Values

StatusMeaning
CREATEDMaker submitted, awaiting checker approval
PENDING_APPROVALIn checker queue
APPROVEDChecker approved, provisioning in progress
REJECTEDChecker rejected
SUCCESSCards fully provisioned and active
FAILEDProvisioning failed (check reason field)

Bulk Tracking Pattern

GET /fetch-by-status/SUCCESS?pageNo=0&pageSize=100
→ shows how many out of a bulk batch completed successfully

GET /fetch-by-status/FAILED?pageNo=0&pageSize=100
→ shows failed records with error reasons for retry

Server

Use the corporate server URLs for this endpoint.

GET
/v1/corporate-issuances/fetch-by-status/{status}

Authorization

bearerAuth tenantId
AuthorizationBearer <token>

JWT Bearer token from the Authentication API

In: header

X-TENANT-ID<token>

Your unique tenant identifier assigned during onboarding

In: header

Path Parameters

status*string

Issuance status to filter by

Value in"CREATED" | "PENDING_APPROVAL" | "APPROVED" | "REJECTED" | "SUCCESS" | "FAILED"

Query Parameters

pageNo?integer
Default0
pageSize?integer
Default10

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/middleware/v1/corporate-issuances/fetch-by-status/SUCCESS?pageNo=0&pageSize=20" \  -H "X-TENANT-ID: ACME_CORP"
{
  "result": [
    {
      "applicationNumber": "BULK-APP-2026-001",
      "currentStatus": "SUCCESS",
      "issuanceType": "Bulk",
      "beneficiaries": [
        {
          "firstName": "Alice",
          "lastName": "Smith",
          "kit": "160000013",
          "cardNumber": "861530XXXXXX0106"
        },
        {
          "firstName": "Bob",
          "lastName": "Jones",
          "kit": "160000014",
          "cardNumber": "861530XXXXXX0107"
        }
      ]
    }
  ],
  "pagination": {
    "pageNo": 0,
    "pageSize": 20,
    "totalElements": 1
  }
}
{
  "type": "https://www.m2pfintech.com/problem/problem-with-message",
  "title": "string",
  "status": 0,
  "detail": "string",
  "message": "error.http.400",
  "businessCode": "string",
  "fieldErrors": [
    {
      "field": "string",
      "message": "string"
    }
  ],
  "cause": {},
  "errorCode": "string",
  "errors": [
    "string"
  ],
  "languageCode": "string",
  "localizedMessage": "string",
  "suppressed": [
    {}
  ]
}

Fetch Issuances by Hierarchy and Status GET

Narrows the status query to a specific hierarchy node (branch, sub-corporate, etc.). Useful when the partner portal needs to show issuance status **per branch** rather than across the entire tenant. ### Server Use the **corporate** server URLs for this endpoint.

Pre-Validate Forex Issuance POST

Checks whether a forex card issuance request is within the configured limits for the customer and product. ### Response - `exceptionRequired: false` → Within limits, proceed with issuance - `exceptionRequired: true` → Limit exceeded, exception approval needed