接入前准备

更新时间:2024.11.18

1. 申请接入

商户向weixinpay_scoreBD@tencent.com发送邮件接入申请,微信侧在7-10个工作日内进行评估并回复审核结果。申请需包含以下信息:

1、 服务商基本信息。

基本信息

示例值

服务商名称

李四网络公司

服务商商户号

14xxxxxxxx

服务商类型

普通服务商

主营业务覆盖行业

零售

主营业务内容

为零售商户提供支付、营销等能力支持

微信支付商户数

100

预计接入支付分商户数

50

2、服务商简介。

3、需要使用微信支付分的产品方案或业务场景描述(如有人脸设备接入时,请标注“需人脸能力”)。

4、服务商联系人、联系方式。

2. 产品权限开通

微信支付审核通过并回复邮件后,服务商登录微信支付服务商平台,在【产品功能-我的产品】中开通微信支付分产品权限。

3. 商户入驻

服务商向微信支付发送邮件,为子商户提交资料申请开通微信支付分功能。微信审核通过后,服务商可登录微信支付服务商平台,在微信支付分产品功能下,向子商户发起授权邀请;

子商户授权同意开通并签署业务协议后,子商户微信支付分产品权限开通成功。

4. 技术对接及验收

  1. 服务商根据微信支付提供的技术对接资料包括技术QA、验收标准及配置信息文档进行开发;

  2. 服务商在技术联调过程中为子商户完成服务ID技术信息配置及测试名单开通;

  3. 服务商开发测试完成后开始验收及上工作,流程如下:

    • 产品方案验收,需提供以下相关信息:

      • 业务全流程的录屏

      • 提供App(包括IOS和安卓)、小程序或H5的验收环境,微信侧将在验收环境内进行验收确认。

    • 确认灰度时间并在约定时间灰度上线。

    • 验收完成后微信侧即完成配置,产品正式上线。

5. 微信支付分合作品牌线上应用规范

具体规范请参见或详细规范参见:微信支付分合作品牌线上应用规范.pdf

6. 关于【需确认订单模式】和【免确认订单模式】的接口说明

支付分的接口分为【需确认订单模式】和【免确认订单模式】两种接口模式。通过本文档,为商户说明两种模板的主要区别。

6.1 接口调用权限说明

【免确认订单模式】是高级接口权限,需特殊申请才能使用:

使用支付分的行业/场景,目前只能调用【需确认订单模式】接口。

接口调用权限与服务ID相关,在申请服务ID时,只有上述场景下的服务ID,才有权限调用【免确认订单模式】接口。即只有在上述场景下,创单订单API接口中need_user_confirm字段才能传。 false:免确认订单。

6.2 接口能力差异点

【需确认订单模式】:为订单维度的授权,是单次授权。用户授权了当前这一笔订单后,商户仅能针对当前订单调用一次支付分的订单创建和完结(免密代扣)

【免确认单模式】:为商户服务维度的授权,是长期授权。用户授权了该商户服务后,商户可以通过后台接口进行支付分的订单创建和完结(免密代扣)

6.3 典型场景说明

【需确认订单模式】典型场景说明:

例如 免押租借场景,均是使用【需确认订单模式】,以租借充电宝为例

用户从商户端(小程序/App/H5),跳入微信支付分页面,即第二步【确认订单】页面,在微信支付分的订单确认页面,进行授权。

授权成功,则成功创建一笔支付分订单(确认订单成功),服务结束后,商户可以调用支付分完结接口,对该笔订单进行完结扣费。(每次使用,均需跳确认订单页面进行授权)

下次用户需要使用服务(例如再次租借充电宝),用户需要按上面流程,再次进入到【确认订单】页面,进行授权。

【免确认订单模式】典型场景说明:

例如 网约车先乘后付,是使用的【免确认订单模式】

首次使用,用户先从商户端(小程序/App/H5),跳入微信支付分页面,进行商户服务的授权

授权成功后,商户即可通过后台接口,进行支付分订单的创建和完结。用户无需再进入支付分授权页面进行授权。

只要用户没有解除商户服务授权,商户都可以通过后台接口进行创单和完结订单。

6.4 先免与先享字段选择说明

创单API中,有一个risk_fund 字段,其中name 字段,有先免和先享2种不同值

【先免模式】 是指:免押金、免预付款、免保证金等场景,例如免押金租借各类物品,免预付款可先预定定制商品,免保证金可先进行物品拍卖等。 若评估不通过,则可直接在确认订单页上进行押金/预付款/保证金支付。

例如:

【先享模式】 是指评估不通过,不能通过缴纳费用,继续进行服务使用。例如信用回收,用户评估通过,可先获得部分回收款,若评估不通过,则无法获得。

例如:

用户若评估不通过,只能返回商户。

  • 【需确认订单模式】:可传先免模式的字段

  • 【免确认订单模式】:只可传先享模式字段

(免确认订单模式下,若评估不通过,会创单失败,返回)

1{"code":"INVALID_REQUEST","message":"存在未完结订单"} 
2
3{"code":"INVALID_REQUEST","message":"综合评估不通过"}

存在未完结订单:指当前用户可能有其他未付款的支付分订单或在其他商户侧创建了过多的支付分订单,本次订单评估有风险,被风控拦截。

综合评估不通过:指因为其他的原因被风控拦截。

6.5 模式及相关参数解说

【需确认订单模式】: 即先免模式(评估不通过可交押金)

对应创建支付分订单风险金额名称name:

  • DEPOSIT:押金

  • ADVANCE:预付款

  • CASH_DEPOSIT:保证金

对应创建支付分订单是否需要用户确认need_user_confirm:

true:需确认订单

对应创建支付分订单用户标识OpenID是否必填:

需确认订单:不填


【免确认订单模式】: 即先享模式(评估不通过不可使用服务)。

对应创建支付分订单风险金额名称name:

ESTIMATE_ORDER_COST:预估订单费用

对应创建支付分订单是否需要用户确认need_user_confirm:

false:免确认订单

对应创建支付分订单用户标识OpenID是否必填:

免确认订单:必填