通用查询接口

商户钱包余额

查询当前商户在开户国家下的结算钱包。

接口

项目	值
Method	GET
Path	/api/v1/merchant/wallet

无需 Query 参数；国家与币种由商户开户配置决定。

响应 data

字段	说明
countryCode	如 TH
currency	如 THB
balance	可用余额（可发起代付）
frozenBalance	冻结余额（进行中的代付等）
status	1 = 正常

示例

{
  "code": 0,
  "msg": "ok",
  "data": {
    "countryCode": "TH",
    "currency": "THB",
    "balance": "50000.00",
    "frozenBalance": "1010.00",
    "status": 1
  }
}

TIP

创建代付前请确认 balance >= netAmount（本单金额 + 手续费）。

商户钱包流水

接口

项目	值
Method	GET
Path	/api/v1/merchant/wallet/transactions

Query

参数	默认	说明
page	1	页码
pageSize	20	每页条数，最大 100

响应 data

{
  "total": 2,
  "list": [
    {
      "id": 1001,
      "txNo": "MW20260608001",
      "countryCode": "TH",
      "currency": "THB",
      "txType": "MERCHANT_PAYOUT_FREEZE",
      "direction": -1,
      "amount": "1010.00",
      "balanceBefore": "50000.00",
      "balanceAfter": "48990.00",
      "relatedOrderNo": "PO20260608120000123456",
      "remark": "merchant payout freeze",
      "createdAt": "2026-06-08T12:00:00Z"
    }
  ]
}

常见 txType

txType	说明
MERCHANT_PAYOUT_FREEZE	代付创建冻结
MERCHANT_PAYOUT_SETTLE	代付完成扣减冻结
MERCHANT_PAYOUT_REFUND	代付取消退回
MERCHANT_PAYIN_SETTLE	代收完成入账
admin_adjust	运营调账

代付银行列表

泰国代收 bankCode 当前仅支持 QR。

泰国代付银行转账请填写 bankCode，可用编码见 泰国首页 bankCode 枚举。历史字段 bankName 可继续传入，平台兼容接收但不会参与路由、费率匹配或上游请求。