转账接口

转账模块适合付款到微信零钱、支付宝账户或银行卡，也可配合余额查询做打款前检查。

接口清单

接口	方法	说明
/api/transferOrder	POST	发起转账
/api/transfer/query	POST	查询转账订单
/api/transfer/balance/query	POST	查询转账可用余额
notifyUrl	POST	转账通知

发起转账核心字段

字段	必填	说明
mchOrderNo	是	商户转账单号
ifCode	是	接口代码，如 wxpay、alipay
entryType	是	入账方式，如 WX_CASH、ALIPAY_CASH、BANK_CARD
accountNo	是	收款账号，微信 openId / 支付宝账号 / 银行卡号
accountName	否	收款人姓名
bankName	否	银行名称，银行卡场景可记录
amount	是	转账金额，单位分
currency	是	货币代码，建议 CNY
transferDesc	否	转账说明
notifyUrl	否	异步通知地址
clientIp	否	客户端 IP

发起转账示例

{
  "mchNo": "M202604230001",
  "appId": "APP202604230001",
  "mchOrderNo": "TR202604230001",
  "ifCode": "wxpay",
  "entryType": "WX_CASH",
  "accountNo": "o6BcIwvTvIqf1zXZohc61biryWik",
  "accountName": "测试用户",
  "amount": 100,
  "currency": "CNY",
  "transferDesc": "分销佣金打款",
  "notifyUrl": "https://merchant.example.com/notify/transfer",
  "clientIp": "127.0.0.1",
  "version": "1.0",
  "reqTime": 1713849600000,
  "signType": "MD5",
  "sign": "YOUR_SIGN"
}

状态处理建议

转账接口返回 code = 0 通常只表示“已受理”，最终是否成功建议以查询或通知结果为准。

可重点关注：

• transferId
• state
• channelOrderNo
• errCode
• errMsg
• successTime

常见接入经验：

• state = 2 一般可视为成功。
• state = 3 一般可视为失败。
• 中间状态应继续查单确认。

余额查询

在高频打款或钱包余额场景下，建议先查询渠道可用余额，再决定是否发起转账。

字段	说明
ifCode	渠道接口代码
mchNo	商户号
appId	应用 ID
reqTime	请求时间
sign	请求签名

转账通知

通知参数通常包含：

• transferId
• mchOrderNo
• amount
• ifCode
• entryType
• state
• errCode
• errMsg
• sign

业务系统处理完成后返回 success，否则平台会继续重试通知。