通用查询接口

商户钱包余额

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

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

无需 Query 参数；国家与币种由商户开户配置决定（巴基斯坦为 PK / PKR）。

响应 data

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

TIP

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

商户钱包流水

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

Query：page（默认 1）、pageSize（默认 20，最大 100）。

常见 txType

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

代付 bankCode

巴基斯坦代付须传 bankCode（平台编码，全大写），完整列表见：

附录 · 代付 bankCode 枚举

类型	bankCode 示例	主要填写字段
钱包	JAZZCASH、EASYPAISA	payee_mobile
银行	HBL、MCB、UBL 等	payee_account

代收 bankCode 见 代收 bankCode 枚举。

Open API 暂无独立的「银行列表」查询接口；请以上述附录为准对接。