开发指引

3. 商家转账业务接入说明

3.1. 业务流程图

3.2. 关键步骤说明

第一步：发起商家转账到零钱

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

2、商户发起商家转账，先调用《发起商家转账》接口发起商家转账请求，当返回的订单状态为WAIT_USER_CONFIRM时，可唤起用户确认收款。

4、当返回商户订单状态为ACCEPTED时，需要检查商户资金是否足够，并一定要使用原商家单号及原参数重试，否则可能造成重复转账等资金风险。

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

第二步：用户确认收款

1、当发起商家转账成功且返回的订单状态为WAIT_USER_CONFIRM时，通过《请求用户确认收款JSAPI》或《APP调起用户确认收款》来请求用户确认收款
2、用户确认收款后，商户订单状态为SUCCESS，微信支付系统并通过《商家转账完成通知》来通知商户系统

第三步：查询商家转账状态

1、商户收到通知后，通过商户单号查询转账单、微信转账单号查询转账单API接口查询商家转账订单，确认商家转账订单状态为SUCCESS，来确定是否收款成功。

2、使用API接口只支持查询最近30天内的商家转账订单，30天之前的商家转账订单请登录商户平台查询。

3、商家转账订单的状态SUCCESS，FAIL，CANCELLED是终态，商户可以根据以上几个状态做不同的业务展示

第四步：申请下载电子回单(按需使用)

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

2、支持受理6个月内的商家转账电子回单。

3、仅支持为SUCCESS状态的商家转账订单(不满足条件返回 400 INVALID_REQUEST)；

4、详情参考 商户单号申请电子回单、商户单号查询电子回单、微信单号申请电子回单、微信单号查询电子回单。