转账功能
转账用于商家主动向个人付款的场景(佣金发放、报销、提现等),支持微信、支付宝、抖音三个通道,可从界面发起或通过 API 调用。
功能入口
| 功能 | 菜单路径(两端一致) |
|---|---|
| 发起转账 | 转账订单 → 发起转账 |
| 转账记录 | 转账订单 → 转账记录 |
| 通道转账 | 转账订单 → 通道转账 → 微信转账 / 支付宝转账 / 抖音转账 |
「转账订单」是与「交易订单」平级的顶级菜单;「转账记录」展示容器层交易,「通道转账」按通道展示转账单明细(含领取链接)。
界面发起转账
进入「发起转账」页面后,按通道选择对应的页签(微信 / 支付宝 / 抖音),三套表单结构一致:
- 选择商户与通道商户:运营端先选择目标商户(商户端固定为当前商户),再选择该通道下的直连通道商户(发起转账的扣款主体);
- 填写转账信息:
| 字段 | 说明 |
|---|---|
| 商户转账号 | 系统自动生成,作为幂等键(同一转账号不会重复转账),可修改 |
| 金额 | 转账金额 |
| 收款人账号 | 收款人的 openid / user_id,可通过扫码授权回填 |
| 收款人姓名 | 部分场景必填(见下方金额规则) |
| 标题 / 原因 | 转账展示给收款人的标题与原因 |
- 选择转账场景与报备信息:场景列表由通道配置决定——微信读取通道商户的「转账配置」,支付宝读取场景配置列表,抖音来自主数据枚举。转账场景需要事先在通道商户详情的交易配置中维护;
- 提交前二次确认;微信转账成功后会返回确认收款链接(发起成功弹窗中可复制链接转给收款人,通道转账详情抽屉内含链接二维码;收款人确认后到账)。
各通道金额规则(界面会自动校验)
- 微信:金额小于 0.3 元时不能填写收款人姓名;大于等于 2000 元时必填收款人姓名
- 支付宝:单笔最低 0.1 元;大于等于 50000 元必填付款理由;收款人类型为登录名时必填收款人姓名
- 抖音:金额大于等于 2000 元时必填收款人姓名;收款人账号为手机号时须填 11 位数字
转账单管理(通道转账)
「通道转账」下的微信 / 支付宝 / 抖音转账页:
查询条件:转账号、商户转账号、收款人账号、状态、创建时间。
操作:
| 操作 | 条件 | 说明 |
|---|---|---|
| 查看 | — | 详情抽屉,微信转账单包含领取链接二维码 |
| 同步 | 转账中 | 拉取通道侧最新状态(如微信收款人是否已确认) |
| 关闭 | 转账中 | 关闭未完成的转账单 |
状态(资金状态):转账中 / 成功 / 失败 / 关闭(页面展示「转账中」,即处理中;微信转账在收款人确认前会停留在「转账中」)。
API 转账
业务系统调用 POST /unipay/transfer 发起转账,POST /unipay/sync/order/transfer 查询结果,参数说明见发起转账。
前置条件
转账依赖通道侧配置,发起前确认:
- 通道商户的转账场景已配置(微信:通道商户详情 → 交易配置 → 转账配置;含「转账发起应用」,仅支持公众号);
- 通道密钥已配置且具备转账权限(部分通道需要单独开通转账产品)。