跳到主要内容

全部提款

将会员账户中的所有余额一次性提取。

API 信息​

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

请求​

请求标头​

POST /v2/members/cashout 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": "player001",
  "transId": "CASHOUT-20250129-001",
}

加密后的请求体​

{
  "cipherText": "G0ZMDELeJwx+7JcIfIFOLJjkSzANPu6krGM2uw==..."
}
欄位类型必填说明
usernamestring是会员账号
transIdstring是交易 ID

响应​

成功响应​

{
  "code": 0,
  "message": "No error.",
  "data": {
      "amount": 2323.582,
      "balance": 0,
  },
  "logUUID": "06b1c410-c8cb-462b-8fb8-b437c7dc74f0"
}

响应欄位说明​

欄位类型说明
data.amountnumber提款金额
data.balancenumber提款后余额

错误响应​

{
  "code": 2,
  "message": "The balance is not enough.",
  "logUUID": "6589bf8d-fe74-48bd-841a-71bf8f848f86"
}

常見错误码​

状态码说明
2余额不足
3交易已存在
8会员不存在
11参数错误
19账号无效
20会员钱包暫时鎖定
83认证失敗
84解密失敗

更多错误码说明请参考：附录 - 错误码总览

注意事项​

  1. 余额检查：如果余额为零，会返回错误码 2
  2. 交易 ID 唯一性：每个 transId 必须唯一，防止重复提款
  3. 即时更新：提款成功后，会员余额立即更新为 0
  4. 冪等性：使用相同的 transId 重复提交会返回相同结果
  5. 与普通提款的区别：
    • 全部提款：不需要指定金额，提取所有余额

相关 API​