6月14日消息,微信支付对《发起商家转账API》做出新的接口调整,相关变更将于6月19日起正式生效。此次升级的核心在于为开发者提供更清晰的批次单据受理状态。接口返回中新增“批次状态(batch_status)”字段,可取值与现有“查询转账API”保持一致,便于统一对照。
按照官方文档,当一次请求成功进入受理环节后,系统在批次创建起的三自然日内,允许以完全一致的批次单信息重复调用该接口。此时,接口会直接返回HTTP状态码“200 OK”及完整的应答参数,而不会再创建新的批次数据,避免重复转账。

开发者若希望利用此功能,需在请求体内依次放入以下字段:商家批次单号、转账说明、绑定的APPID、总转账金额、总笔数、收款方OpenID列表、收款用户姓名(如需校验实名)。接口返回仅表示“请求受理成功”,并未确认资金到账。真正的付款结果仍以“查询转账API”回执为准。
此外,若出现批次单号、业务参数等重复情况,三日内再次调用均会被视为同一笔请求并得到原响应内容,从而杜绝因幂等问题造成多次打款。为保证资金安全,建议开发者在代码层面增加查单轮询或异步通知校验,确保实时掌握每一笔转账的终态。
本次更新还同步优化了错误码描述,新增“参数缺失”“批次已存在”“业务规则冲突”等更细粒度提示,方便快速定位问题。已上线的老版本接口在三日内仍可正常通信,但官方强烈建议尽快迁至新版本,以获得更直观的批次状态追踪体验。