Balance TransferAPI
Question and answers for our services
Player API
Description
 Register / Create Player API- -1 : unknow
 - 0 : female
 - 1 : male
 
 Login API
 Open Game API
 Authenticate Algorithm
 Register / Create Player API
				| Request | : | {Protocol}://{Endpoint}/api/partner/register | 
| Protocol | : | HTTP | 
| Method | : | POST | 
| Content-Type | : | application/json | 
| Endpoint | : | https://api.data333.com/api/partner/register | 
| This method using to register new player in 998’s database system | ||
| Post data model | ||
| Name | Data Type | Description | 
| Partner | string | Partner’s name that will be provided by 998 company to partner | 
| Sign | string | A hashed string that will be generated by using CreateSign method | 
| TimeStamp | long | Unix time at partner side when send request | 
| UserName | string | Login name of player. Start with alphabet charater, contains only character and digit. | 
| Password | string | Password of player | 
| Fullname | string | Full name of player | 
| string | Valid email of player | |
| Mobile | string | Mobile phone of player | 
| Gender | integer | 
                     | 
            
| DoB | string | Date of birthday in format yyyy-MM-dd | 
| Currency | string | Valid currency code | 
| BankName | string | Valid bank name | 
| BankAccountNo | string | Serial bank account number | 
Response data format
| Name | Data Type | Description | 
| Error | integer | Error code. Negative means fail operation. Zero means successfully operation. | 
| Message | string | Error message in text format | 
| Sign | string | A hashed string that will be generated by using CreateSign method | 
| TimeStamp | long | Unix time at 998’s side when send response | 
 Login API
				| Request | : | {Protocol}://{Endpoint}/api/partner/login | 
| Protocol | : | HTTP | 
| Method | : | POST | 
| Content-Type | : | application/json | 
| Endpoint | : | https://api.data333.com/api/partner/login | 
| This method using for player to login into 998 system | ||
| Note: parter no need to send the plain text password to 998’s API | ||
| Post data model | ||
| Name | Data Type | Description | 
| Partner | string | Partner’s name that will be provided by 998 company to partner | 
| Sign | string | A hashed string that will be generated by using CreateSign method | 
| TimeStamp | long | Unix time at partner side when send request | 
| UserName | string | Login name of player. Start with alphabet charater, contains only character and digit. | 
Response data format
| Name | Data Type | Description | 
| Error | integer | Error code. Negative means fail operation. Zero means successfully operation. | 
| Message | string | Error message in text format | 
| Sign | string | A hashed string that will be generated by using CreateSign method | 
| TimeStamp | long | Unix time at 998’s side when send response | 
| Token | string | Session token key of player in 998’s system | 
 Open Game API
				| Request | : | {Protocol}://{Endpoint}/api/play/login | 
| Protocol | : | HTTP | 
| Method | : | POST | 
| Content-Type | : | application/json | 
| Endpoint | : | https://api.data333.com/api/play/login | 
| Headers | : | Authorization : Bearer {token} | 
| This method using for player to open game | ||
| Post data model | ||
| Name | Data Type | Description | 
| Vendor | string | Game provider, will be provided by 998 company | 
| Device | string | optional | 
| Browser | string | Browser that used by player to open game | 
| GameCode | string | Game that player want to open and play | 
| GameHall | string | Using for CQ9 game only, default value is "CQ9" | 
| Lang | string | Language code | 
| MerchantCode | string | Using to open Skywind slot game only | 
| Ticket | string | Using to open Pragmatic game only | 
| SeatId | string | Using for open Lucky Streak live casino game only | 
| Tag | string | Optional | 
| GameProvider | string | Optional | 
Response data format
| Name | Data Type | Description | 
| Error | integer | Error code. Negative means fail operation. Zero means successfully operation. | 
| Message | string | Error message in text format | 
| Success | boolean | Action result | 
| Result | string | Game URL returned | 
| Token | string | URL extend information | 
 Authenticate Algorithm
				| 998 system will provide to partner data as example below | ||
| Partner name | : | aaa | 
| Partner key | : | FB67717C-26AE-4B01-BCA2-09DBC1A19A50 | 
| Hash algorithm | : | SHA256 | 
| Every API call, partner need to create a hashed string (sign) using | ||
| TimeStamp | : | Unix time stamp in partner system | 
| Partner name | : | provided by 998 company | 
| Partner key | : | provided by 998 company | 
| Create sign string by using method as below | ||
                    
                         | 
            ||
Transfer Wallet API
Description
 Deposit
 Withdraw
 Check Transaction Status- 0 : fail
 - 1 : success
 - -1 : not existed
 
 Get Balance
 Deposit
				| Request | : | {Protocol}://{Endpoint}/rest/transfer/deposit | 
| Protocol | : | HTTP | 
| Method | : | POST | 
| Content-Type | : | application/json | 
| Endpoint | : | https://walletapi.data333.com/rest/transfer/deposit | 
| This method using to deposit the credit to player’s wallet. | ||
| Post data model | ||
| Name | Data Type | Description | 
| Partner | string | Partner’s name that will be provided by 998 company to partner | 
| Sign | string | A hashed string that will be generated by using CreateSign method | 
| TimeStamp | long | Unix time at partner side when send request | 
| TransactionId | string | Unique transaction id from partner side | 
| Player | string | Username of player | 
| Amount | decimal(18,6) | Deposit amount, is positive number | 
Response data format
| Name | Data Type | Description | 
| Error | integer | Error code. Negative means fail operation. Zero means successfully operation. | 
| Message | string | Error message in text format | 
| Sign | string | A hashed string that will be generated by using CreateSign method | 
| TimeStamp | long | Unix time at 998’s side when send response | 
| Player | string | Username of player | 
| Amount | decimal(18,6) | Deposit amount, is positive number | 
| Before | decimal(18,6) | Balance before deposit | 
| After | decimal(18,6) | Balance before deposit | 
 Withdraw
				| Request | : | {Protocol}://{Endpoint}/rest/transfer/withdrawal | 
| Protocol | : | HTTP | 
| Method | : | POST | 
| Content-Type | : | application/json | 
| Endpoint | : | https://walletapi.data333.com/rest/transfer/withdrawal | 
| This method using to withdraw the credit from player’s wallet. | ||
| Post data model | ||
| Name | Data Type | Description | 
| Partner | string | Partner’s name that will be provided by 998 company to partner | 
| Sign | string | A hashed string that will be generated by using CreateSign method | 
| TimeStamp | long | Unix time at partner side when send request | 
| TransactionId | string | Unique transaction id from partner side | 
| Player | string | Username of player | 
| Amount | decimal(18,6) | Withdrawal amount, is positive number | 
Response data format
| Name | Data Type | Description | 
| Error | integer | Error code. Negative means fail operation. Zero means successfully operation. | 
| Message | string | Error message in text format | 
| Sign | string | A hashed string that will be generated by using CreateSign method | 
| TimeStamp | long | Unix time at 998’s side when send response | 
| Player | string | Username of player | 
| Amount | decimal(18,6) | Deposit amount, is positive number | 
| Before | decimal(18,6) | Balance after deposit | 
| After | decimal(18,6) | Balance after deposit | 
 Check Transaction Status
				| Request | : | {Protocol}://{Endpoint}/api/play/login | 
| Protocol | : | HTTP | 
| Method | : | POST | 
| Content-Type | : | application/json | 
| Endpoint | : | https://walletapi.data333.com/rest/transfer/check | 
| This method using to check status of a certain transaction. | ||
| Post data model | ||
| Name | Data Type | Description | 
| Partner | string | Partner’s name that will be provided by 998 company to partner | 
| Sign | string | A hashed string that will be generated by using CreateSign method | 
| TimeStamp | long | Unix time at partner side when send request | 
| TransactionId | string | Unique transaction id from partner side | 
Response data format
| Name | Data Type | Description | 
| Error | integer | Error code. Negative means fail operation. Zero means successfully operation. | 
| Message | string | Error message in text format | 
| Sign | string | A hashed string that will be generated by using CreateSign method | 
| TimeStamp | long | Unix time at 998’s side when send response | 
| Status | integer | 
                     | 
            
 Get Balance
				| Description | : | get Current balance of player | 
| Protocol | : | HTTP | 
| Method | : | HTTP POST | 
| Content-Type | : | application/json | 
| EndPoint | : | https://api.data333.com/api/player/balance | 
| Post data model | : | 
| Name | Data Type | Description | 
| Partner | string | Partner’s name that will be provided by 998 company to partner | 
| Sign | string | A hashed string that will be generated by using CreateSign method | 
| TimeStamp | long | Unix time at partner side when send request | 
| UserName | string | UserName of Player | 
Response data format
| Name | Data Type | Description | 
| Error | integer | Error code. Negative means fail operation. Zero means successfully operation. | 
| Message | string | Error message in text format | 
| Sign | string | A hashed string that will be generated by using CreateSign method | 
| TimeStamp | long | Unix time at 998’s side when send response | 
| Balance | Decimal | Balance of Player |