转账订单状态查询

当下游商户在调用转账接口（充值/提现）时，如遇网络抖动、超时等异常情况，商户可以通过该接口传入充值/提现时所使用的唯一转账流水号（transfer_id），主动查询该笔交易最终的成功/失败状态，以进行对账和状态补单。直接查询本地数据，结果准确可靠。

接口信息

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

请求头

Header	值	必填
Authorization	Bearer {agent_token}	✅ 必填

请求参数

参数名	类型	必填	说明
transfer_id	string	是	商户在发起存款/取款交易时，自定义且唯一的交易流水号

请求示例

curl -X POST https://api.example.com/papi/v1/order/status \
  -H "Authorization: Bearer {agent_token}" \
  -d "transfer_id=TXN202606152311001"

响应字段

Data 字段说明

属性名	类型	说明
transfer_id	string	商户请求时传入的唯一流水号
hub_member_id	string	玩家在本网关平台的唯一 ID（格式：商户前缀_玩家ID）
currency	string	交易币种
amount	decimal	交易金额
transfer_type	string	交易类型： • deposit（存款/充值） • withdraw（取款/提现）
balance_before	decimal	交易前玩家账户余额
balance_after	decimal	交易后玩家账户余额
status	string	交易状态： • success（交易成功） • failed（交易失败） • pending（处理中/待定）
remark	string	备注说明
created_at	string	订单创建时间 (ISO 8601 格式)

成功响应 (HTTP 200)

{
  "code": 0,
  "data": {
    "transfer_id": "TXN202606152311001",
    "hub_member_id": "TESTAGENT_PLAYER_USER_001",
    "currency": "CNY",
    "amount": 500.00,
    "transfer_type": "deposit",
    "balance_before": 1000.00,
    "balance_after": 1500.00,
    "status": "success",
    "remark": "",
    "created_at": "2026-06-15T23:11:00+08:00"
  },
  "msg": "ok"
}

失败响应

订单不存在 (HTTP 200)

{
  "code": 7,
  "data": {},
  "msg": "order not found"
}