Appendix

This page lists all possible error codes and their Description in the Seamless Wallet API.

Status Code Overview

Code	Response Message	Description	Related API
0	No error	Request Success	All APIs
5	Game is not found	Games does not exist or has been delisted	Open Game、Query Bet Logs、Query Bet Detail、Query Bet Replay
6	The username already exist	Player Account already exists	Create Player
7	Internal server error	Internal system error	All APIs
8	The User is not exist	Player does not exist	Open Game、Query Bet Detail
10	Agent code was not found or block	Agent does not exist or is blocked	Get Access Token
11	Parameters error	Parameters error	All APIs
14	The BetId is not exist	Query Bet Logs does not exist	Query Bet Detail、Query Bet Replay
19	Invalid account	Invalid account	Open Game
77	Too many request, please try again later	Too many requests	Query Bet Logs、Query Daily Report、Query player report
78	Operator card spinId was used	Item ID already used	Send Operator Card, Send Simple FreeSpin Operator Card
81	Branch config not found	Branch config not found	Open Game、Query Bet Logs
82	Please check Site ID is for this player	Site ID does not match Player	Open Game
83	Signature verification failed	Signature verification failed	All APIs requiring verification
84	Encryption failed	Encryption failed	All APIs requiring encryption
85	Key config setting error	Encryption setting read error	All APIs
86	Game is restricted	Games rejected due to restrictions	Open Game, Send Operator Card, Send Simple FreeSpin Operator Card

Error Code Classification

Success Codes

Code	Description
0	Request Success, no error

Player Management Errors

Code	Description	Possible Causes	Handling Suggestion
6	Player Account already exists	Create Player using an already registered Player Account	Use a different Player Account
8	Player does not exist	Query or operate on a non-existent Player	Confirm Player ID or Player Account is correct, call Create Player API first
19	Invalid Player Account	Player Account format error or abnormal Status	Check Player Account format and Status
20	Player wallet is temporarily locked	Player wallet temporarily locked for some reason	Try again later or Contact Customer Support Team

Game Management Errors

Code	Description	Possible Causes	Handling Suggestion
5	Games is not found	Using an invalid Game Code or Games has been delisted	Confirm Game Code is correct
82	Site ID mismatch	Site ID does not correspond to Player	Contact Customer Support Team, provide logUUID
86	Games rejected due to restrictions	This Games cannot be opened due to currency, line, etc.	First confirm whether the Game List document has a Description, contact technical support, provide logUUID

Query Bet Log Errors

Code	Description	Possible Causes	Handling Suggestion
14	Query Bet Logs does not exist	Query a non-existent Query Bet Logs or incorrect txTime	Confirm betId and txTime parameters are correct

Item-related Errors

Code	Description	Possible Causes	Handling Suggestion
78	Duplicate Item Transaction ID	Item ID has already been used	Change spinId parameter

System Level Errors

Code	Description	Possible Causes	Handling Suggestion
7	Internal system error	Internal server error	Contact Customer Support Team, provide logUUID
10	Agent error	agentId or secret is incorrect, or Agent is blocked	Check Authentication information, contact administrator to confirm Status
11	Parameters error	Request parameters missing, format error, or do not meet requirements	Check all Required parameters and format
77	Too many requests	Too many requests sent in a short period	Reduce request frequency, try again later
81	Branch config not found	System configuration missing	Contact Customer Support Team
83	Signature verification failed	Signature calculation error or incorrect request header	Check signature generation logic and request header
84	Encryption failed	Encryption key error or incorrect encryption method	Check encryption configuration and implementation

Authentication Related Error Details

10 - Agent Error

Occurs in /v2/auth API, possible causes:

1. agentId does not exist: Used an unregistered Agent ID
2. secret is incorrect: The secret parameter after decryption does not match agentId
3. Agent is blocked: Agent ID has been disabled by the system

Handling Suggestion:

• Confirm agentId and secret are correct
• Contact Customer Support Team to check Agent Status
• Check whether the x-agentid request header matches the agentId in the body

83 - Signature Verification Failed

This is the most common Authentication error, which may be caused by the following reasons:

1. Incorrect signature string combination order

   • The correct order should be: agentId + secret + timestamp + nonce + cipherText
   • Use SHA256 (not HMAC-SHA256) for hashing

2. Timestamp verification failed

   • Operator and server time difference exceeds the allowed range (usually ±1 minute)
   • Incorrect timestamp format (should be a 13-digit millisecond timestamp)

3. Nonce verification failed

   • Used a duplicate nonce value (each request must be unique)

4. Missing or incorrect request header

   • Missing required request headers: x-agentid, x-timestamp, x-nonce, x-signature
   • Request header value is inconsistent with the value used for actual signature calculation

Handling Suggestion:

• Refer to Get Access Token Overview to check signature generation logic
• Ensure server time synchronization (using NTP)
• Generate a new nonce for each request
• Confirm all request headers are set correctly

84 - Encryption Failed

Encryption/decryption related errors:

1. Incorrect encryption method: Must use AES-256-GCM
2. Incorrect key: Encryption key configuration is incorrect
3. Incorrect data format: Data format before encryption is incorrect

Handling Suggestion:

• Check whether the encryption implementation uses AES-256-GCM
• Confirm the encryption key is correct
• Refer to the encryption example in Get Access Token Overview

Transaction Status Code

After the Operator API receives a request from the platform, the status field in the response format represents the transaction result.

Status	Description
0000	Success
9999	Failed
1006	Invalid session
2000	Transaction ID not found
2001	Transaction ID already exists
2002	Insufficient current Balance
2003	No cancellation, bet Status: established (for Bet cancellation only)

Games Type Mapping Table

Code	Description
1	Slot

Language

Code	Description
en	English (default Language; if VP does not support the corresponding Language, then it's the default Language)
zh-Hans	Simplified Chinese
th	Thai
my	Burmese
id	Indonesian
vi	Vietnamese
jp	Japanese
pt	Portuguese
ko	Korean
tl	Tagalog
hi	Hindi
ms	Malay
bn	Bengali
es	Spanish

Currencies

Code	Description
AUD	Australian Dollar
BDT	Bangladeshi Taka
BRL	Brazilian Real
CAD	Canadian Dollar
CNY	Chinese Yuan
EGP	Egyptian Pound
EUR	Euro
GBP	British Pound
HKD	Hong Kong Dollar
IDR	Indonesian Rupiah (1:1000)
IDR1	Indonesian Rupiah (1:1)
INR	Indian Rupee
JPY	Japanese Yen
KHR	Cambodian Riel
KRW	Korean Won (1:1)
KRW1	Korean Won (1:1000)
LAK	Lao Kip (1:1000)
LAK1	Lao Kip (1:1)
LKR	Sri Lankan Rupee
MMK	Myanmar Kyat (1:1000)
MMK1	Myanmar Kyat (1:1)
MXN	Mexican Peso
MYR	Malaysian Ringgit
MYR1	Malaysian Ringgit (displayed as 100:1 in Games)
NPR	Nepalese Rupee
NZD	New Zealand Dollar
PHP	Philippine Peso
THB	Thai Baht
THB1	Thai Baht (displayed as 100:1 in Games)
USD	US Dollar
USDT	Tether
VND	Vietnamese Dong (1:1000)
VND1	Vietnamese Dong (1:1)
ZAR	South African Rand

Transaction Source Codes

Code	Description
1	Regular Bet
2	Mission System
3	Red Packet Draw
4	System Reward
5	Open Treasure Chest
6	Cash Voucher
7	Multi-Prize
8	Card
9	Operator Card

Related Documentation

• Get Access Token Overview
• API Usage Description