Update Low Balance Alert
Updates an existing alert configuration. Can modify threshold amount and/or notification recipients.
Authorization
bearerAuth tenantId JWT Bearer token from the Authentication API
In: header
Your unique tenant identifier assigned during onboarding
In: header
Header Parameters
Your unique tenant identifier
Request Body
application/json
Corporate entity ID
Corporate pool account number
Type of alert
Amount threshold to trigger alert
Response Body
application/json
curl -X POST "https://sandbox-api.m2pprepaid.com/prepaid/middleware/v1/corporate-alert/configuration/update" \ -H "X-TENANT-ID: ACME_CORP" \ -H "Content-Type: application/json" \ -d '{}'{
"corporateId": "CORP123",
"accountNumber": "17568190551480014",
"alertType": "CORPORATE_LOW_BALANCE_ALERT",
"thresholdAmount": 50000,
"emailRecipients": [
"finance@acme.com"
],
"mobileRecipients": [
"9876543210"
]
}Add / Modify / Remove Lien POST
Place a new lien (ADD), modify an existing lien (ADJUST), or fully release a lien (REMOVE) on a wallet's balance. A lien is a temporary hold that reduces the available balance without debiting funds. **ADD** — Place a new hold on the specified amount **ADJUST** — Modify an existing lien (pass new total, not delta) **REMOVE** — Fully release a lien (lienAmount is ignored) Common use cases: pre-authorization, security deposits, staged debits.
Update Wallet Status POST
Updates the status of a specific wallet associated with a cardholder. This is used for controlling what transactions are allowed on the wallet. Common scenarios include: ### Use Cases - **Temporary Freeze**: Lock a wallet when suspicious activity is detected. The cardholder can't transact but you can unlock it later without losing any data. - **Permanent Block**: Block a wallet for compliance violations or confirmed fraud. Requires support intervention to unblock. - **Fraud Prevention**: Mark a wallet as FRAUD to suspend all operations pending investigation. - **Customer Self-Service**: Allow cardholders to block their own wallet via your app (CUSTOMER_BLOCKED status). - **Credit Freeze**: Prevent new loads while allowing the cardholder to spend existing balance. - **Debit Freeze**: Allow loads/credits but prevent spending (e.g., during dispute investigation). - **Refund Only**: After card closure, allow only refund credits to process. - **Reactivation**: Change status back to ACTIVE to restore full transaction capabilities. ### Status Transition Rules Not all status transitions are allowed. Key constraints: - `CLOSED` → Cannot transition to any other status (permanent) - `EXPIRED` → Cannot transition to any other status (permanent) - `FRAUD` → Can only be changed by authorized support roles - `BLOCKED` → Can only be unblocked by authorized support roles - `LOCKED` → Can be changed to `ACTIVE` (unlock) by the partner - `ACTIVE` → Can transition to `LOCKED`, `BLOCKED`, `CREDIT_FREEZE`, `DEBIT_FREEZE`, etc.