Batch Send FeatureGame Operator Card

Send FEATURE GAME cards to specified Players, supports sending to multiple Players for multiple Games at once
Note: FEATURE GAME Cards: Regular Feature Games Card, Powerful Feature Games Card, Super Powerful Feature Games Card

API Information

• URL：POST /v2/items/usesimplefeaturegame/batch
• 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

{
  "usernames": ["alice01", "bob02"],
  "gameCodes": ["VP_240001_1", "VP_240002_1"],
  "spinIds": [
    "fg_alice_g1_0001",
    "fg_alice_g2_0002",
    "fg_bob_g1_0003",
    "fg_bob_g2_0004"
  ],
  "cardType": 11,
  "itemBet": 50,
  "maxWinAmount": 3000,
  "expiredTime": "2026-04-30T12:00:00.000Z"
}

Field	Type	Required	Description
usernames	string Array	Yes	Player Account
gameCodes	string Array	Yes	Game Code
spinIds	string Array	No	Operator Card Unique Identifier; if not filled, the system will automatically generate it
cardType	number	Yes	Card Type
itemBet	number	No	Operator Card Bet Amount, can be filled according to BetList; if not filled, the minimum Bet will be used by default
maxWinAmount	number	No	Maximum Win Amount
expiredTime	string	No	Card Expiration Time

Response

Success Response

{
  "code": 0,
  "message": "No error.",
  "data": {
    "successList": [
      {
        "username": "alice01",
        "gameCode": "VP_230001_1",
        "spinId": "spin_alice_g1_0001",
        "code": 0,
        "message": "No error.",
        "itemId": "generated-item-id1"
      },
      {
        "username": "alice01",
        "gameCode": "VP_230003_1",
        "spinId": "spin_alice_g1_0001",
        "code": 0,
        "message": "No error.",
        "itemId": "generated-item-id2"
      }
    ],
    "failedList": [
      {
        "username": "bob02",
        "gameCode": "VP_230001_1",
        "spinId": "spin_bob_g2_0004",
        "code": 8,
        "message": "The User is not exist"
      },
      {
        "username": "bob02",
        "gameCode": "VP_230003_1",
        "spinId": "spin_bob_g2_0004",
        "code": 8,
        "message": "The User is not exist"
      }
    ]
  },
  "logUUID": "c6a85c7b-6108-4c88-95fb-fd79a1bda0a1"
}

Field	Type	Description
code	number	Response code, 0 indicates Success
message	string	Response message
data.successList	Object Array	List of successfully sent Items
data.failedList	Object Array	List of failed Item sends
logUUID	string	Request tracking ID for troubleshooting and log queries

• Item Send List Parameter Description

Field	Type	Description
username	number	Player Account
gameCode	string	Game Code
spinId	string	Operator Card Unique Identifier
code	number	Item send result response code
message	string	Item send result response message
itemId	string	System Operator Card ID, only generated in the successful Item send list

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 Game 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

SpinId number does not match the item combination.

{
    "code": 11,
    "message": "spinIds length must match usernames x gameCodes combinations",
    "logUUID": "2b82cfaf-d6ad-48fa-9963-4d91639b9b31"
}

Important Notes

1. spinId Uniqueness：Each spinId must be unique and cannot be reused
2. spinId Completeness：If spinId is provided, it must match the number of "Player Account" x "Game Code" combinations; otherwise, it will Trigger an error
3. Immediate Effect：Every FEATURE GAME card sent successfully by this API takes immediate effect
4. Partial Sending：This batch of Items will not fail to send entirely due to some Items failing to send successfully

Common QA

Q1: Does the FEATURE GAME 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 FEATURE GAME 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 FEATURE GAME automatically Settle?

A: Automatic Settlement

Related APIs

• Cancel Operator Card
• Query Operator Card Status
• Batch Send FreeSpin Operator Card