API LibraryIssuance V2 (recommended)

Approve/Reject Unified Issuance (v2)

Maker-checker state transition endpoint for v2 unified issuances.

Use this to approve or reject issuances that are in CREATED or PENDING_APPROVAL status.

Flow

Fetch issuance by status to get the id
Submit state-transition with id and action (APPROVED/REJECTED)
On APPROVED → system processes issuance → status becomes SUCCESS
On REJECTED → issuance is rejected and no cards are created

Server

Use the corporate server URLs for this endpoint.

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

Header Parameters

X-TENANT-ID*string

Your unique tenant identifier

Request Body

application/json

id*string

MongoDB ObjectId from create issuance response

action*string

Approval action

Value in"APPROVED" | "REJECTED"

remarks?string

Optional remarks for rejection

Response Body

`application/json`

curl -X POST "https://sandbox-api.m2pprepaid.com/prepaid/middleware/v2/issuances/state-transition" \  -H "X-TENANT-ID: ACME_CORP" \  -H "Content-Type: application/json" \  -d '{    "id": "6a0431f65de0228d6be3575c",    "action": "APPROVED"  }'

{
  "result": {
    "currentStatus": "APPROVED",
    "id": "6a0431f65de0228d6be3575c",
    "applicationNumber": "532470",
    "issuanceChannel": "Corporate",
    "issuanceType": "Single",
    "noOfCards": 0,
    "noOfCardsRequested": 1
  }
}

Fetch Unified Issuance by ID (v2) GET

Fetch complete issuance details by MongoDB ObjectId. Use this to get the full issuance record including card details after approval. ### Server Use the **corporate** server URLs for this endpoint.

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