跳到主要内容

取消平台卡

玩家未使用前可取消，若玩家已进入游戏中触发动画，则无法取消。

API 信息​

  • 端点：POST /v2/items/cancel
  • 认证：Bearer Token
  • 加密：请求使用 AES-256-GCM 加密，响应为明文 JSON

请求​

请求标头​

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

请求参数​

加密前的参数​

{
   "username": "testaccount001",
   "spinId": "VPItemTestTrans1015_ghjklhtombg"
}

加密后的请求体​

{
  "cipherText": "G0ZMDELeJwx+7JcIfIFOLJjkSzANPu6krGM2uw==..."
}
栏位类型必填说明
usernamestring是玩家账号
spinIdstring是平台卡唯一识别码

响应​

成功响应​

{
   "code": 0,
   "message": "No error.",
   "logUUID": "6589bf8d-fe74-48bd-841a-71bf8f848f86"
}

错误响应​

已取消完成或不存在​

{
   "code": 4,
   "message": "The transaction doesn`t exist.",
   "logUUID": "6589bf8d-fe74-48bd-841a-71bf8f848f86"
}

常见错误码​

状态码说明
4交易不存在、已取消完成，或无法取消（FeatureGame 卡使用中）
8玩家不存在
11参数错误
83认证失败
84解密失败

注意事项​

  1. spinId 唯一性：使用 spinId 来识别要取消的平台卡
  2. 幂等性：相同 spinId 的重复取消请求会返回相同结果
  3. 取消时机：必须在平台卡未使用完毕前进行取消，若玩家已进入游戏中触发动画，则无法取消

常见 QA​

Q1: 使用中的平台卡能否取消？​

依卡片类型而定：

  • FreeSpin 卡：使用一半仍可取消，取消成功回传 code 0
  • FeatureGame 卡：使用一半则无法取消，取消失败回传 code 4，对应情境「无法取消(FeatureGame 卡使用中)」

相关 API​