Send FeatureGame Operator Card
Send FEATURE GAME cards to a specified Player
Note: FEATURE GAME Card: Regular Feature Games Card, Powerful Feature Games Card, Super Powerful Feature Games Card
API Information
- URL:
POST /v2/items/usesimplefeaturegame - 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",
"cardType": 11,
"itemBet": 2,
"maxWinAmount": 10,
"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 |
cardType | number | Yes | Card Type, available parameters 11, 21, 22 |
itemBet | number | No | Operator Card Bet Amount, can be filled according to BetList, if not provided, the minimum Bet will be used by default |
maxWinAmount | number | No | Maximum Win Amount |
expiredTime | string | No | Card Expiry 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 ask 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 ask the Player to re-enter the corresponding Game and use it before resending |
| 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/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 FEATURE GAME card sent by this API takes immediate effect
Common Q&A
Q1: Does the FEATURE GAME card sent by this API have an expiry time?
A: It will automatically Settle 12 hours after sending, regardless of whether the Player logs in or uses the Card.
Q2: Can the FEATURE GAME card sent by this API be canceled?
A: Yes, it can be canceled via the Cancel Operator Card API, but it must be done before the Player enters the Game to use it or before automatic Settlement. Otherwise, it cannot be canceled.
Q3: Will the Player be notified after automatic Settlement?
A: When the Player logs into the Game, a reward notification message will be displayed, but the performance animation will not be re-displayed. If there are multiple Settlement records, only the last Settlement record will be shown.
Q4: If the expiry time is reached, will the Operator Card automatically Settle or be canceled?
A: Canceled, and the Operator Card spinId cannot be reused. There will be no record of this transaction in the backend or bet logs.
Q5: If the Player leaves the Game during the Game animation, will the FEATURE GAME automatically Settle?
A: Automatically Settles
Q6: What is the interaction logic between "expiredTime" and automatic Settlement for the Card?
A: Expiry and invalidation times are always calculated from the moment of sending, regardless of whether the Player logs in or uses the Card. The default expiry time is 12 hours; even if expiredTime is set to more than 12 hours from the moment of sending, it will be reduced to 12 hours. If expiredTime is set to less than 12 hours, that set time will be the invalidation time, and the card will automatically expire when that time is reached.