玩家余额回收 (主动下分)

包网系统可以在玩家退出游戏大厅或需要立即退还资金时，主动调用此接口收回玩家在 VCT 平台的所有本地剩余余额。

调用此接口后，VCT 平台会将该玩家的所有本地活跃钱包余额清零，并立即同步发起 额度回收回调 (/settle)，将最终的额度退回至包网系统主钱包中。

接口信息

属性	值
路径	POST /papi/v1/player/reclaim
认证	Agent Token（Bearer）
Content-Type	application/x-www-form-urlencoded

请求参数

参数名	类型	必填	说明
member_id	string	是	玩家唯一标识（包网侧玩家 ID）

请求示例

curl -X POST https://api.example.com/papi/v1/player/reclaim \
  -H "Authorization: Bearer {agent_token}" \
  -d "member_id=player_001"

响应字段

Data 字段结构

字段	类型	说明
member_id	string	玩家包网侧 ID
reclaimed_amount	decimal	成功回收并结算返回的资金总额
currency	string	结算的货币代码（若没有余额或无需结算，返回空字符串）

成功响应

• 成功收回资金（触发 /settle 回调加款）：

  {
    "status": true,
    "code": 0,
    "data": {
      "member_id": "player_001",
      "reclaimed_amount": 100.00,
      "currency": "MYR"
    },
    "msg": "获取成功"
  }

• 无需收回资金（本地钱包已是 0 余额）：

  {
    "status": true,
    "code": 0,
    "data": {
      "member_id": "player_001",
      "reclaimed_amount": 0,
      "currency": ""
    },
    "msg": "获取成功"
  }

失败响应

{
  "status": false,
  "code": 7,
  "data": {},
  "msg": "player_not_found"
}