Send FreeSpin Operator Card
Send FREE SPIN cards to specified Player
Note: FREE SPIN Cards: 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,
"expiredTime": "2026-04-12T00:00:00.000Z"
}
| 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, Upper Limit is 100 |
maxWinAmount | number | No | Maximum Win Amount |
itemBet | number | No | Operator Card Bet Amount, can be filled according to BetList; 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 |
expiredTime | string | No | Card Expiration Time |
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, is offline, or does not support this currency, please confirm if 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 spinId; if you have questions, contact Customer Support |
| 86 | Game is restricted | Please refer to the Game List document or inquire with Customer Support |
| 87 | Invalid item parameter value | Reconfirm parameter rules or Contact Customer Support Team |
| 88 | Only one item can be active at a time in the same game | Please have Player re-enter the corresponding Games and use it before sending again |
| 89 | The item has not been used yet, or the spinId does not exist | Reconfirm if the Item has been used or if the Item has expired or does not exist |
Error Response Example
Operator Card Parameter Combination Error
{
"code": 87,
"message": "Invalid item parameter value",
"logUUID": "c6a85c7b-6108-4c88-95fb-fd79a1bda0a1"
}
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：The FREE SPIN card sent by this API takes immediate effect
Common QA
Q1: Does the FREE SPIN sent by this API have an expiration time?
A: After sending, if the Player has not logged into the Games to use it, it will automatically Settle 12 hours after sending.
Q2: Can the FREE SPIN sent by this API be cancelled?
A: Yes, it can be cancelled via the Cancel Operator Card API, but it must be before the Player enters the Games to use it or before automatic Settlement; otherwise, it cannot be cancelled.
Q3: Will Player be notified after automatic Settlement?
A: When Player logs into the Games, a reward notification message will be displayed, but the animation will not be re-shown.
Q4: If the expiration time is reached, will the Operator Card automatically Settle or be cancelled?
A: It will be cancelled, and that Operator Card spinId will not be reusable. There will be no record of this entry in the backend or bet logs.
Q5: If Player leaves the Games during the Games animation, will the FREE SPIN automatically Settle?
A: If Player exits midway and returns to the Games, it will continue until all uses are completed before Settlement.