Seamless codes
The 5-digit codes of the Seamless Wallet contract — your system always returns these inside HTTP 200 (except 30002, which may be HTTP 401).
These codes belong to best-system and are stable — they never change regardless of which game the player is on.
| code | Name | Meaning |
|---|---|---|
| 0 | SUCCESS | Success |
| 10001 | SEAMLESS_USER_NOT_FOUND | Player not found on the agent system |
| 10002 | SEAMLESS_INSUFFICIENT_BALANCE | Insufficient balance for the debit |
| 20001 | SEAMLESS_TXN_NOT_FOUND | Referenced transaction (ref_txn_id) not found |
| 20002 | SEAMLESS_DUPLICATE_TXN | Duplicate transaction (txn_id already processed) |
| 30002 | SEAMLESS_INVALID_SIGNATURE | Invalid X-Signature |
| 40003 | SEAMLESS_FORBIDDEN | Forbidden (api-key/IP) |
| 50001 | SEAMLESS_INTERNAL_ERROR | Internal error on the agent system |