1. 3.1 统一交易类指引
3ypay产品接口文档
  • 1.总体介绍
    • 1.1 阅读人员
    • 1.2 名词解释
    • 1.3 调试工具说明
  • 2.接口规范
    • 2.1 接口格式定义
    • 2.2 加签验签说明
    • 2.3 参数说明
    • 2.5 内部测试版sdk
  • 3.统一交易类
    • 3.1 统一交易类指引
      • 3.1.1【微信】 扫码交易指引
      • 3.1.3【微信】小程序交易指引
      • 3.1.4【微信】JSAPI交易指引
      • 3.1.5【微信】APP交易指引
      • 3.1.6【微信】H5交易指引
      • 3.1.7【微信】资金管控业务说明
      • 3.1.8【抖音】APP交易指引
      • 3.1.9【抖音】H5交易指引
    • 3.2 统一交易类接口
      • 3.2.1 统一支付接口
      • 3.2.2 统一交易查询
      • 3.2.3 统一交易通知
      • 3.2.4 统一退款接口
      • 3.2.5 统一退款查询
      • 3.2.6 统一退款通知
  • 4.支付宝产品类
    • 4.1 安全发接口
      • 4.1.1 安全发指引
      • 4.1.2 安全发API接口
        • 4.1.2.1 单笔转账接口
        • 4.1.2.2 单笔转账查询
        • 4.1.2.3 转账异步通知
        • 4.1.2.4 转账回单申请
        • 4.1.2.5 转账回单下载
    • 4.2 直付通接口
      • 4.2.1 直付通指引
      • 4.2.2 直付通API接口
        • 4.2.2.1 统一支付接口
        • 4.2.2.2 统一交易查询
        • 4.2.2.3 统一交易通知
        • 4.2.2.4 统一交易退款
        • 4.2.2.5 统一退款查询
        • 4.2.2.6 统一退款通知
      • 4.2.3 支付宝商家转账（定制）
        • 4.2.3.1 支付宝商家转账
  • 5.订单分账类
    • 5.1 订单分账指引
      • 5.1.1 控台分账指引
        • 5.1.1.1 控台自动分账指引
        • 5.1.1.2 控台手动分账指引
      • 5.1.2 接口分账指引
    • 5.2 订单分账接口
      • 5.2.1 请求分账
      • 5.2.2 分账查询
      • 5.2.3 分账完结
      • 5.2.4 分账退款
      • 5.2.5 分账退款查询
      • 5.2.6 分账结果通知
      • 5.2.7 分账退款通知
  • 6.余额分账类
    • 6.1 余额分账指引
    • 6.2 余额分账接口
      • 6.2.1 余额分账申请
      • 6.2.2 余额分账查询
      • 6.2.3 余额分账退款
      • 6.2.4 余额退款查询
      • 6.2.5 余额分账异步通知
      • 6.2.6 余额退款异步通知
  • 7.风控管理类
    • 7.1 投诉管理类
    • 7.2 风险管理类
  • 8.商户管理类
    • 8.1 商户进件类
      • 8.1.1 进件文件上传
      • 8.1.2 商户入网申请
      • 8.1.3 商户入网信息查询
      • 8.1.4 商户结算信息变更
      • 8.1.5 商户产品信息变更
      • 8.1.6 商户信息变更查询
      • 8.1.7 进件状态通知
      • 8.1.8 变更状态通知
    • 8.2 微信支付宝管理类
      • 8.2.1 商户AUT报备查询
      • 8.2.2 微信支付配置
      • 8.2.3 微信支付配置查询
      • 8.2.4 商户AUT拆分
    • 8.3 分账接收方管理类
      • 分账接收方录入
      • 分账接收方查询
      • 分账接收方变更
      • 分账变更查询
      • 分账关系绑定
      • 分账关系解绑
      • 分账关系更新
      • 分账关系查询
      • 入网报备通知
      • 结算变更通知
  • 9. 先享后付类
    • 9.1 微信支付分
    • 9.2 支付宝先享后付
  • 10.账户管理类
    • 10.1.分账提现管理类
      • 10.1.1 分账提现申请
      • 10.1.2 分账提现查询
      • 10.1.3 提现结果通知
  • 产品手册
    • AI智能路由指引-内测
    • 商户控台操作手册
    • AT投诉渠道配置
      • 微信投诉风险渠道配置
    • AT风险处理指引
      • 微信风控处理指引
    • 抖音支付申请指引
      • 抖音支付合作商家政策
      • 抖音支付申请材料
    • 支付宝可信商户报备
      • 可信降打扰权益服务介绍
      • 商户可信降打扰（存量客户）
      • 准入可信降打扰（新增客户）
    • 分账相关指引
      • 分账订阅-商户使用指引
  • 回收站
  • 数据模型
    • 公共请求参数
    • 公共返回参数
    • 公共响应结构
    • 商户入网材料
    • 业务请求参数
    • 营业执照信息
    • 文件上传请求
    • 法人证件信息
    • 商户入网请求
    • 结算卡信息
    • 进件标识查询请求
    • 入网查询请求
    • 结算卡变更请求
    • 产品变更请求
    • 结算卡更新信息
    • 变更查询请求
    • AUT查询请求
    • 分账关系绑定请求
    • AUT微信配置请求
    • 分账关系解绑请求
    • AUT配置详情查询请求
    • 分账关系更新请求
    • 微信支付配置响应
    • 分账关系查询请求
    • 授权目录配置状态
    • 商户入网响应
    • AppId配置状态
    • 商户变更响应
    • AUT拆分请求
    • 变更审核状态响应
    • 商户基本信息
    • 分账关系响应
    • 人员证件信息
    • 余额分账申请请求
    • 商户营业执照信息
    • 余额分账明细请求
    • 商户经营信息
    • 分账查询请求
    • 经营场景信息
    • 分账退款申请请求
    • 经营资质信息
    • 分账退款明细请求
    • 商户结算卡信息
    • 分账退款查询请求
    • 对公卡信息
    • 余额分账响应
    • 签约信息
    • 分账明细响应
    • 产品开通信息
    • 余额分账退款响应
    • 产品配置详情
    • 分账退款明细响应
    • AUT查询响应
    • 提现申请请求
    • 异步通知响应结构
    • 提现查询请求
    • 进件状态通知数据
    • 提现响应数据
    • 变更状态通知数据
    • 入网报备通知数据
    • 余额分账通知数据
    • 分账明细通知
    • 余额退款通知数据
    • 提现通知数据
    • 退款明细通知
  1. 3.1 统一交易类指引

3.1.7【微信】资金管控业务说明

1 业务背景#

为保障小程序健康交易生态，进一步提升用户购物体验，微信推出订单发货管理功能及相应的资金管控，即针对特定行业类型（实物电商类）的小程序订单，做交易资金的管控处理，被管控小程序（APPID）的交易，在支付成功后微信冻结资金，等待用户确认收货或系统自动确认收货后再进行资金结算。
为支持受理此类业务，汇联已完成机构对接，现对间联模式下的微信小程序资金管控业务接入做以下说明，各代理商和商户可按需接入。
具体参见微信文档 订单发货管理功能介绍及接入计划|微信开放文档。
微信结算周期说明（在此基础上我司D+1结算给商户）：
发货方式结算周期
快递物流1. 用户主动确认收货：收货后按商户结算周期结算
2. 未主动确认：发货后第10天系统自动确认收货后结算
自提/同城配送/虚拟发货1. 用户主动确认收货：收货后按商户结算周期结算
2. 未主动确认：发货后第2天系统自动确认收货后结算

2 业务说明#

2.1 总体业务流程#

相比于现有微信小程序支付交易，被管控订单的支付下单流程不变（仍然调用JSAPI接口），但在支付完成后，新增清算状态。此后，增加商户侧发货流程及用户收货操作，收货确认的第二个工作日，汇联根据机构侧来款，根据商户的结算周期开展清洁算处理（D1/T1)，如商户周期为T1，则在收货确认的T+2到账。

2.2 汇联系统说明#

2.2.1 新增微信订单发货业务开通#

通过商管后台或者销售人员进件时或者业务变更新增【微信-资金管控】产品

2.2.2 新增微信订单发货业务交易处理#

（1）支持资金管控业务受理
新增微信电商资金管控支付方式【MINI_APP_FUND】
支付成功后订单状态仍为中间状态（clearStatus=0， IsMpFund=1，代表支付成功未发货，消费订单业务未完成，因此不进清算不记账）。
解冻前退货、解冻后退货、交易查询、交易结果通知复用现有接口
支持微信电商消费交易后分账处理。

3 商户接入指引#

3.1 业务开通#

3.1.1 小程序在微信接入微信订单发货管理#

1. 被管控小程序类型#

按微信要求，对特定种类的小程序做资金管控，具体受管控的小程序类型参见 实物电商类小程序分类。

2. 完成商户与小程序APPID的关联申请#

商户后台
APPID绑定接口
微信商户后台
image.png

3. 小程序对关联商户号完成【交易结算管理确认授权】#

商户号授权后方可关联成功。
操作说明：小程序管理后台，在「支付与交易-微信支付」模块，对正在关联的商户号完成交易结算管理确认授权。详情可查看文档 小程序交易结算管理确认说明。
image.png

4. 小程序接入【微信发货管理】#

拟接入微信订单发货业务的小程序，需要接入微信发货管理。
为保障消费者尽快拿到货物，避免微信投诉，以及商户尽早收到结算资金，建议商户在用户消费成功后（清算状态为“处理中”），15个自然日内完成发货操作，超期将影响对账文件数据及结算时效。
提供两种发货方式：
不管哪种方式，消费者都会收到微信推送的收货确认通知，用户确认收货或超时系统自动确认收货后，微信解冻资金，进入结算流程。
【微信后台发货】：登录 小程序管理后台，在「支付与交易-订单管理-发货信息录入」模块，上传相关物流及商品信息。可选择【批量发货】或【按订单发货】。
【发货信息管理】
image.png
【批量发货】
image.png
【按订单发货】
image.png
【微信API发货】：由商户或服务商，直接对接微信API，完成订单发货，参见文档 微信发货API文档。

5.消费者用户在微信端确认收货#

image.png
image.png
image.png

3.1.2 商户在汇联开通业务#

通过商管后台或者销售人员进件时或者业务变更新增【微信-资金管控】产品

3.2 交易对接#

3.2.1 支付流程#

1. 核心校验：#

APPID被管控+请求交易类型按【微信电商消费】上送+商户已开通【微信电商消费】：按微信订单发货业务处理，资金被管控。
APPID被管控+请求交易类型按【微信电商消费】上送+商户未开通【微信电商消费】：支付失败。
APPID被管控+请求交易类型按【普通小程序支付】上送：支付失败。
APPID未管控+请求交易类型按【微信电商消费】上送：支付失败。
APPID未管控+请求交易类型按【普通小程序支付】上送+商户已开通【普通小程序支付】：按普通小程序支付处理，资金不被管控。
APPID未管控+请求交易类型按【普通小程序支付】上送+商户未开通【普通小程序支付】：支付失败。

2. 如需交易后分账#

在按【微信电商消费】交易类型调用JSAPI接口请求时，正常上送对应标识即可。
交易后分账：指解冻来款后，商户收到清算完成通知（clearStatus=1），商户可发起订单分账，根据商户结算周期对分账订单结算出款。

3.2.2 退款流程#

支付成功后资金解冻前，支持部分退款、全额退款

4 常见问题#

1.
退款时效：支付成功时起算
2.
小程序APPID生效规则
存量appid：微信会通知7天后管控生效的APPID，即接收到通知7日后0点生效。
新增appid：一旦在微信侧开通则管控实时生效。
3.
客户如何得知小程序APPID是否已被管控
4.
目前仅在绑定appid、业管拆分时给出管控状态提示。
5.
管控时间临界点的管控状态以支付成功时间为准，非下单时间。
6.
为保障消费者尽快拿到货物，避免微信投诉，以及商户尽早收到结算资金，建议商户在用户消费成功后，15个自然日内完成发货操作，超期将影响对账文件数据及结算时效。
上一页
3.1.6【微信】H5交易指引
下一页
3.1.8【抖音】APP交易指引
Built with