跳至主要内容

取消平台卡

取消已使用但尚未完成流水的平台卡。

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交易不存在或已取消完成
8會員不存在
11參數錯誤
83認證失敗
84解密失敗

注意事項​

  1. spinId 唯一性：使用 spinId 來識別要取消的平台卡
  2. 冪等性：相同 spinId 的重複取消請求會返回相同結果
  3. 取消時機：必須在平台卡未使用完畢前進行取消，若玩家已進入遊戲中觸發動畫，則無法取消

相關 API​