Error Codes
Tokenization Errors
Error codes for digital wallet token operations and network service failures.
Errors related to digital wallet provisioning (Apple Pay, Google Pay, Samsung Pay) and token lifecycle management.
| Code | HTTP | Message | Scenario | Resolution |
|---|---|---|---|---|
TOK_001 | 400 | Card not eligible | The card is not eligible for tokenization — may be an unsupported product type or inactive card | Check card status and product type |
TOK_002 | 400 | Token not found | The provided token reference ID does not exist | Verify the token reference ID via getTokens API |
TOK_003 | 400 | Token already suspended | Attempting to suspend a token that is already suspended | No action needed — token is already in suspended state |
TOK_004 | 400 | Token already active | Attempting to resume a token that is already active | No action needed — token is already active |
TOK_010 | 502 | VTS service failure | Visa Token Service is temporarily unavailable | Retry after 1-2 minutes; if persistent, contact M2P support |
TOK_011 | 502 | MDES service failure | Mastercard Digital Enablement Service is temporarily unavailable | Retry after 1-2 minutes; if persistent, contact M2P support |
TOK_012 | 502 | NPCI TKM failure | RuPay NPCI Token Key Management service is temporarily unavailable | Retry after 1-2 minutes; if persistent, contact M2P support |
Forex Errors (FX_xxx)
Errors related to exchange rate queries and multi-currency operations.
| Code | HTTP | Message | Scenario | Resolution |
|---|---|---|---|---|
FX_001 | 400 | Unsupported currency pair | The requested currency pair is not available for your program | Check supported currencies with M2P |
FX_002 | 400 | Rate expired | The previously quoted exchange rate has expired | Request a fresh rate quote |
FX_003 | 400 | Conversion limit exceeded | The conversion amount exceeds the configured forex limits | Reduce the amount or request a limit increase |
FX_004 | 502 | Rate feed unavailable | The exchange rate data feed is temporarily down | Retry after 1 minute |