Error Codes
Transaction Errors
Error codes for credit, debit, reversal, and transaction processing issues.
Errors related to wallet credits, debits, reversals, and transaction processing.
| Code | HTTP | Message | Scenario | Resolution |
|---|---|---|---|---|
TXN_001 | 400 | Invalid kit number | The kit number was not found in the system | Verify the kit number exists |
TXN_002 | 400 | Invalid amount | Amount is zero, negative, or in an invalid format | Provide a positive numeric amount |
TXN_003 | 400 | Insufficient balance | Wallet balance is less than the requested debit amount | Load funds before attempting the debit |
TXN_004 | 400 | Daily limit exceeded | The daily transaction limit has been reached | Wait for the next day or request a limit increase |
TXN_005 | 400 | Monthly limit exceeded | The monthly transaction limit has been reached | Wait for the next month or request a limit increase |
TXN_006 | 400 | Per-transaction limit exceeded | A single transaction exceeds the maximum allowed amount | Split into smaller transactions |
TXN_007 | 400 | Card not active | The card is locked, blocked, or inactive | Unlock the card or request a replacement |
TXN_008 | 400 | Invalid transaction type | Unrecognized transactionType value | Use a valid type: M2C, C2M, LOAD, P2P, REFUND, BILL_PAY |
TXN_009 | 409 | Duplicate transaction | The externalTransactionId has already been processed | Use a unique external transaction ID for each new transaction |
TXN_010 | 400 | Invalid currency | The currency code is not supported for this product | Check supported currencies for your program |
TXN_011 | 400 | Wallet frozen | The wallet has been temporarily frozen by admin action | Contact M2P support for resolution |
TXN_020 | 400 | Reversal not allowed | The original transaction is not eligible for reversal | Check original transaction status and type |
TXN_021 | 400 | Partial reversal exceeds original | The reversal amount is greater than the original transaction | Reduce the reversal amount |
TXN_022 | 400 | Already reversed | The transaction has already been fully reversed | No further action needed |
TXN_030 | 502 | Core processing failure | Internal system error during transaction processing | Retry after 30 seconds; if persistent, contact M2P support |