Check Wallet Balance

Retrieves the current available balance for a specific wallet. For multi-currency cards (e.g., forex cards), you can check the balance of each currency wallet individually.

Response Details

The balance response includes:

• Available Balance: The amount currently available for transactions
• Wallet Currency: The currency of the wallet (INR, USD, EUR, etc.)
• Wallet Status: Current status of the wallet

When to Use

• Pre-Transaction Check: Verify sufficient balance before initiating a debit/transfer
• Balance Display: Show real-time balance in your app/portal
• Reconciliation: Compare balances for accounting and reconciliation purposes

curl -X POST "https://sandbox-api.m2pprepaid.com/prepaid/customer/v1/wallets/balance" \  -H "X-TENANT-ID: ACME_CORP" \  -H "Content-Type: application/json" \  -d '{    "entityId": "798782647420001622070825",    "accountId": "17556437212850072"  }'

{
  "result": {
    "accountId": "17556437212850072",
    "entityId": "798782647420001622070825",
    "balance": 15250.75,
    "currency": "INR",
    "status": "ACTIVE"
  },
  "pagination": null
}

{
  "type": "https://www.m2pfintech.com/problem/problem-with-message",
  "title": "Bad Request",
  "status": 400,
  "detail": "entityId: must not be empty",
  "message": "error.http.400"
}

{
  "type": "https://www.m2pfintech.com/problem/problem-with-message",
  "title": "Customer does not exist",
  "status": 409,
  "detail": "Customer does not exist for id: 798782647420001622070825",
  "message": "error.business",
  "businessCode": "PPCUST_002"
}