1. 接口规则

为了在保证支付安全的前提下，带给商户简单、一致且易用的开发体验，我们推出了全新的微信支付APIv3接口。该版本API的具体规则请参考APIv3接口规则。

2. 开发准备

开发者应当依据自身的编程语言来构建并配置相应的开发环境。

如果开发者使用过PostmanAPI的调试，建议在正式开发之前，使用 Postman签名脚本进行接口体验。

1、调用接口前，开发者需要参考接入前准备确认已完成权限开通和产品配置，特别是关于API发起转账的相关配置一定要正确。

2、商户发起商家转账到零钱，先调用《发起批量转账》接口发起批次转账请求，受理成功将返回批次单号，此时并不代表转账成功。

3、当返回错误码为“SYSTEM_ERROR”时，请不要更换商家批次单号，一定要使用原商家批次单号及原参数重试，否则可能造成重复转账等资金风险。

4、受理成功后，在单据创建时间的3个自然日内使用同样批次单信息请求该接口，均返回应答码“200 OK”及对应的应答参数。

1、使用API接口只支持查询最近30天内的转账批次单状态，30天之前的转账批次单请登录商户平台查询。

2、当发起商家转账到零钱请求受理成功之后，需间隔1分钟以上才可调用《通过微信批次单号查询批次单》、《通过商家批次单号查询批次单》接口来查询批次转账状态，若发起转账请求后立即查询，有可能查询到“转账批次单不存在”。

3、当查询到的批次单状态为：WAIT_PAY 时，表示「付款验密人」需要到「微信支付商户助手」输入安全密码验证，24小时内未完成验证，自动关闭批次单。

4、当查询到批次单状态为FINISHED(已完成),才可进行下一步，查询转账明细状态。

当查询到批次单状态为FINISHED(已完成)，才可调用《通过微信明细单号查询明细单》、《通过商家明细单号查询明细单》接口进行转账明细查询。

1、发起转账时传入了收款用户姓名，才支持申请电子回单。

2、支持受理2年内的转账批次电子回单和转账明细电子回单。

3、仅支持已完成状态且至少有一笔成功记录的批次获取转账批次电子回单(不满足条件返回 400 INVALID_REQUEST)；

4、仅支持转账已完成的明细单申请电子回单（不满足条件返回 400 PARAM_ERROR）；