关键概念
更新时间:2024.10.17商家转账支持商家向用户的微信零钱转账,在开始使用商家转账之前,请务必仔细阅读本文档以确保对相关概念和运作机制有充分理解。
概念
商家转账,指商家一次转账的行为
商家转账订单,包括明细的商家明细单号、微信明细单号、明细状态、附言、转账用户 OpenID、转账金额等
商家转账电子回单,是商户使用商家转账给用户之后得到的商家转账凭证电子回单。
运作机制
商户发起商家转账请求后,微信支付会持续尝试锁定商户资金。如果超过24小时仍余额不足或因其他原因导致无法转账,商家转账订单将会被关闭。
为了跟踪商家转账的处理进度,商户系统需要调用查商家转账单接口,以确认商家转账是否成功。
业务流程
简单地说,商家转账的基础流程包括以下几个步骤:
商户服务端调用微信支付的商家转账 API,发起转账请求。请求中包含了转账的金额、收款用户,商户单号等。
微信支付收到请求后,先锁定商户资金,直至转账处理完毕。
当返回的商家转账订单状态为WAIT_USER_CONFIRM时,调用请求用户确认收款JSAPI或APP调起用户确认收款来调起微信请求用户确认收款
当返回的商家转账订单状态为非WAIT_USER_CONFIRM时,可用原商户商户单号进行重试。
如果用户已通过其他方式提现,商户可以主动发起撤销商家转账。
用户看到收款确认信息后进行确认收款操作。
用户确认收款后,微信支付会发送转账结果通知给商户。
商户服务端收到转账结果通知后,调用微信支付的查询转账订单 API,查询转账的状态,并对用户展示转账结果,或者执行其他后续操作。
如果用户24h未确认收款,会退款至商户资金。
商家转账订单状态
批次有六种状态,包括已受理、待收款用户确认、转账成功、转账失败、撤销中、已撤销。
商户可以通过通过查询商家转账单获取商家转账单状态。
状态 | 状态名 | 描述 | 商户可能的操作 |
---|---|---|---|
ACCEPTED | 已受理 | 转账已受理 | 撤销转账订单 |
WAIT_USER_CONFIRM | 待收款用户确认 | 待收款用户确认,可拉起微信收款确认页面进行收款确认 | 撤销转账订单 |
SUCCESS | 转账成功 | 转账成功 | 向用户展现转账结果 |
FAIL | 转账失败 | 转账失败 | 确认失败原因,并决定是否重新发起商家转账 |
CANCELING | 撤销中 | 商户撤销请求受理成功,该笔转账正在撤销中 | 无 |
CANCELLED | 已撤销 | 转账撤销完成 | 向用户展示撤销的结果 |