通用查询接口

商户钱包余额

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

接口

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

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

响应 data

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

示例

{
  "code": 0,
  "msg": "ok",
  "data": {
    "countryCode": "CN",
    "currency": "CNY",
    "balance": "500000.00",
    "frozenBalance": "10030.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": "CN",
      "currency": "CNY",
      "txType": "MERCHANT_PAYOUT_FREEZE",
      "direction": -1,
      "amount": "10030.00",
      "balanceBefore": "500000.00",
      "balanceAfter": "489970.00",
      "relatedOrderNo": "PO20260608150000777777",
      "remark": "merchant payout freeze",
      "createdAt": "2026-06-08T15:00:00Z"
    }
  ]
}

常见 txType

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

代付银行列表

中国代付须使用 银行卡转账（BANK_TRANSFER）：

字段	说明
receiverBankName	开户银行全称
receiverBankCode	联行号（12 位）或运营提供的银行编码
receiverAccount	银行卡号
receiverName	开户姓名

完整联行号表请向运营索取 CN 银行字典；对接测试时可使用沙盒提供的测试卡信息。API 暂无独立「银行列表」公开接口。