Cancel Operator Card
Cancellation is possible before the Player uses it. If the Player has entered the game and triggered the animation, it cannot be cancelled.
API Information
- URL:
POST /v2/items/cancel - Authentication: Bearer Token
- Encryption: Requests are encrypted using AES-256-GCM; responses are returned as plaintext JSON
Request
Request Headers
POST /v2/items/cancel 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
Parameters Before Encryption
{
"username": "testaccount001",
"spinId": "VPItemTestTrans1015_ghjklhtombg"
}
Encrypted Request Body
{
"cipherText": "G0ZMDELeJwx+7JcIfIFOLJjkSzANPu6krGM2uw==..."
}
| Field | Type | Required | Description |
|---|---|---|---|
username | string | Yes | Player Account |
spinId | string | Yes | Operator Card Unique Identifier |
Response
Success Response
{
"code": 0,
"message": "No error.",
"logUUID": "6589bf8d-fe74-48bd-841a-71bf8f848f86"
}
Error Response
Already Cancelled or Not Exists
{
"code": 4,
"message": "The transaction doesn`t exist.",
"logUUID": "6589bf8d-fe74-48bd-841a-71bf8f848f86"
}
Common Error Codes
| Code | Description |
|---|---|
| 4 | Transaction does not exist, already cancelled, or cannot be cancelled (FeatureGame card in use) |
| 8 | Player does not exist |
| 11 | Parameters error |
| 83 | Authentication Failed |
| 84 | Decryption Failed |
Important Notes
- spinId Uniqueness: Use spinId to identify the Operator Card to be cancelled
- Idempotency: Repeated cancellation requests for the same spinId will return the same result
- Cancellation Timing: Cancellation must be done before the Operator Card is used. If the player has entered the game and triggered the animation, it cannot be cancelled
Frequently Asked Questions
Q1: Can an Operator Card in use be cancelled?
Depends on Card Type:
- FreeSpin Card: Can still be cancelled if partially used; successful cancellation returns
code 0 - FeatureGame Card: Cannot be cancelled if partially used; failed cancellation returns
code 4, corresponding to the scenario "Cannot cancel (FeatureGame card in use)"