Error Codes
Card Errors
Error codes for card management operations — lock, unlock, block, PIN, and physical card issues.
Errors related to card lifecycle operations, PIN management, and physical card requests.
| Code | HTTP | Message | Scenario | Resolution |
|---|---|---|---|---|
CARD_001 | 400 | Invalid kit number | Kit number not found in the system | Verify the kit number |
CARD_002 | 400 | Card already locked | Attempting to lock a card that is already in LOCKED status | No action needed — card is already locked |
CARD_003 | 400 | Card not locked | Attempting to unlock a card that is already in ACTIVE status | No action needed — card is already active |
CARD_004 | 400 | Card already blocked | Attempting to block a card that is already permanently blocked | No action needed — consider issuing a replacement |
CARD_005 | 400 | Cannot unlock blocked card | Attempting to unlock a permanently blocked card | Blocking is irreversible — issue a replacement card instead |
CARD_006 | 400 | Card replacement failed | System could not issue a replacement card | Contact M2P support for assistance |
CARD_010 | 400 | Invalid PIN | PIN format is invalid (must be exactly 4 digits) | Provide a properly encrypted 4-digit PIN |
CARD_011 | 400 | PIN encryption error | Gateway could not decrypt the PIN | Verify your encryption implementation matches the Gateway Encryption guide |
CARD_020 | 400 | Physical card already issued | A physical card has already been dispatched for this kit | No action needed — physical card is already in process |
OTP Errors (OTP_xxx)
Errors related to one-time password generation and validation.
| Code | HTTP | Message | Scenario | Resolution |
|---|---|---|---|---|
OTP_001 | 400 | OTP generation failed | SMS delivery or OTP generation failure | Retry, or use an alternate notification channel |
OTP_002 | 400 | Invalid OTP | The OTP entered does not match | Ask the customer to re-enter the OTP carefully |
OTP_003 | 400 | OTP expired | The OTP validity period has elapsed | Generate a new OTP |
OTP_004 | 429 | OTP rate limit | Too many OTP requests in a short period | Wait before requesting a new OTP |
OTP_005 | 400 | Max attempts exceeded | OTP validation has failed 3 or more times | Generate a new OTP — previous OTP is now invalidated |