Send Simple FreeSpin Operator Card
Send FREE SPIN cards to a designated Player. Note: FREE SPIN Card: Free Spin Card, Multiplier Free Spin Card (cardType 1, 2)
API Information
- URL：
POST /v2/items/usesimplefreespin - Authentication：Bearer Token
- Encryption：Requests are encrypted using AES-256-GCM; responses are returned as plaintext JSON
request
Request Headers
POST /v2/items/use HTTP/1.1
Host: api.example.com
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
x-agentid: integratorNBTest04
x-timestamp: 1769746894501
x-nonce: 56ffd5ecd8a3a4457863a0bd7c298fb2
x-signature: 904e97bee2589b93e9747eed0346c68b23d8ff8b568dabaf4b94a5e89093df67
Request Parameters
Decrypted Request
{
"cipherText": "G0ZMDELeJwx+7JcIfIFOLJjkSzANPu6krGM2uw==..."
}
Parameters Before Encryption
{
"username": "VPSysDevTest001",
"spinId": "SystemItemTestTrans150",
"gameCode": "VP_230001_1",
"round": 3,
"maxWinAmount": 10,
"itemBet": 2,
"multiple": 1
}
| Field | Type | Required | Description |
|---|---|---|---|
username | string | Yes | Player Account |
spinId | string | Yes | Operator Card Unique Identifier |
gameCode | string | Yes | Game Code |
round | number | Yes | Number of Rounds |
maxWinAmount | number | No | Max Win Amount |
itemBet | number | No | Operator Card Bet Amount. Refer to BetList for details. If not filled, the minimum Bet will be used by default. |
multiple | number | No | Free Spin Multiplier. Can be 1/2/3/5x. If not filled, 1x will be used by default. |
Response
Success Response
{
"code": 0,
"message": "No error.",
"data": {
"itemId": "f2cb520579c8014452d6f521693a4aa8_VPItemTestTrans1042_ghjklhtombg"
},
"logUUID": "24cdc3b9-9fe8-44de-8391-a96863e46954"
}
| Field | Type | Description |
|---|---|---|
code | number | Response code, 0 indicates Success |
message | string | Response message |
data.itemId | string | System Operator Card ID |
logUUID | string | Request tracking ID for troubleshooting and log queries |
Error Response
Error Codes
| Code | Description | Handling Suggestion |
|---|---|---|
| 5 | Game is not found | Game does not exist, has been delisted, or does not support this currency. Please confirm if the gameCode is correct. |
| 8 | The User is not exist | Player does not exist. Please create Player first. |
| 78 | Operator card spinId was used | Please change the spinId. If you have questions, contact Customer Support for assistance. |
| 86 | Game is restricted | Please refer to the Game List document or ask Customer Support. |
Error Response Example
Operator Card Parameter Combination Error
{
"code": 7,
"message": "Internal server error",
"error": "{\"retStatus\":{\"StatusCode\":80013,\"StatusMsg\":\"RiskInfoError\",\"CheckCode\":0,\"SystemTime\":1760348424576}}",
"logUUID": "24cdc3b9-9fe8-44de-8391-a96863e46954"
}
Operator Card ID Duplicate Usage
{
"code": 78,
"message": "The spinID was used",
"logUUID": "24cdc3b9-9fe8-44de-8391-a96863e46954"
}
Important Notes
- spinId Uniqueness: Each spinId must be unique and cannot be reused.
- Immediate Effect: This API sends FREE SPIN cards with immediate effect.
Frequently Asked Questions
Q1: How to obtain the itemBet List in the sending parameters?
A: The full supported list can be queried via Get Operator Card Information. You can also provide any value, and our system will automatically select the closest and lower bet from that game's betList to send.
Q2: Does the Free Spin sent by this API have an expiration time?
A: After sending, if the Player has not logged in to the game to use it, it will automatically Settlement within 12 hours after sending.
Q3: Can the Free Spin sent by this API be canceled?
A: Yes, it can be canceled via the Cancel Operator Card API, but only before the Player has used it in the game. Once used, it cannot be canceled.
Q4: Will the Player be notified after automatic Settlement?
A: When the Player logs in to the game, a reward notification message will be displayed, but the animation will not be re-shown.