1. 产品介绍
1.1 简介
商户要使用微信、支付宝的支付服务时需要先去微信、支付宝做入驻。斗拱提供了一站式的入驻接入。
1.2 应用场景
适用对象:需要入驻微信或支付宝的商户。
支持:
- 间联模式入驻:商户通过服务商向微信、支付宝申请入驻;
- 直联模式入驻:商户直接向微信、支付宝提交入驻申请;
2. 接入前准备
2.1 商务准备
-
选择接入模式
-
直签模式:指商户与汇付直接签约。具体流程:商户完成协议签署后,将准备好的入网材料提供给汇付销售人员,由汇付销售人员发起商户入网申请,待审核通过入网成功后,商户联系人将收到短信通知控台账号及密码。
-
服务商模式:指服务商与汇付签约,服务商通过接口或控台方式完成商户入网。具体流程:服务商完成协议签署后,将准备好的入网材料提供给汇付销售人员,由汇付销售人员发起服务商入网申请,待审核通过入网成功后,服务商联系人将收到短信通知控台账号及密码。
-
在斗拱完成商户进件入网
- 直签模式:已有汇付销售人员申请开通,商户无须另行操作;
- 服务商模式:
- 控台入网:参考服务商控台进件流程,渠道商接入指引;
- API入网:企业商户调用企业商户基本信息入驻接口 、小微商户调用个人商户基本信息入驻接口 完成开户、绑卡、结算配置。
2.2 对接准备
第一步:密钥获取
联调之前需要先获取公私钥,参见公私解钥参数获取说明;
第二步:公共参数获取
登录服务商/商户控台后,可在开发设置-开发者信息中,获取sys_id,product_id参数信息;
3. 开发指引
3.1 对接规范
调用汇付接口,均采取POST形式提交,数据格式统一为JSON格式,相关SDK及签名方法见链接:
SDK示例:Java SDK
加签验签:v2版接口加签验签
3.2 系统调用流程
3.2.1 微信直连
微信特约商户进件接口
入参关注字段:
参数 | 中文名 | 必填 | 说明 |
---|---|---|---|
app_id | 开发者的应用ID | Y | 微信服务商的APPID; |
mch_id | 商户号 | Y | 微信支付分配服务商的商户号; |
wx_woa_secret | 服务商微信公众号APPID对应密钥 | N | 申请微信公众号支付必填 |
返参关注字段:
参数 | 中文名 | 必填 | 说明 |
---|---|---|---|
applyment_id | 微信支付申请单号 | N | 微信支付分配的申请单号,成功返回 |
微信关注配置接口
入参关注字段:
参数 | 中文名 | 必填 | 说明 |
---|---|---|---|
bind_app_id_conf_list | 绑定APPID配置 | N | jsonArray格式 |
subscribe_conf_list | 关注配置 | N | jsonArray格式 |
pay_path_conf_list | 支付目录配置 | N | jsonArray格式 |
注意返参【绑定APPID配置】【关注配置】【支付目录配置】是分别返回的,有各自返回结果与报文;
3.2.2 微信间连
AT间连证书登记接口:
关注以下请参:
参数 | 中文名 | 必填 | 说明 |
---|---|---|---|
pay_way | 开通类型 | Y | W:微信 A:支付宝;示例值:W |
app_id | 开发者的应用ID | Y | 支付宝:开发者应用ID,微信:服务商的APPID;示例值:wx3767c5bd01df5061 |
mch_id | 商户号 | N | 服务商的商户号,微信必传;示例值:360634064 |
cert_sn | 证书序列号 | N | 请求证书序列号,可在服务商后台查看到,微信必传;示例值:20220818883326714 |
secret_key | 服务商密钥 | N | 服务商密钥,微信必传;示例值:RERE202208182319 |
微信商户配置接口:
关注以下请参:
参数 | 中文名 | 必填 | 说明 |
---|---|---|---|
fee_type | 业务开通类型 | Y | 枚举值参见《微信业务开通类型》说明 |
wx_woa_app_id | 公众号支付Appid | C | 条件必填,示例值:wx3767c5bd01df5061 ;wx_woa_app_id 、wx_woa_path和 wx_applet_app_id三者不能同时为空 |
wx_woa_path | 微信公众号授权目录 | C | 条件必填,示例值:https://paas.huifu.com/shouyintai/demo/h5/;wx_woa_app_id 、wx_woa_path和 wx_applet_app_id三者不能同时为空 |
wx_woa_secret | 微信公众号APPID对应的秘钥 | N | 示例值:64afb60bef3a22ac282aa7880cdaca98 |
wx_applet_app_id | 微信小程序APPID | String | 条件必填,示例值:wx8523175fea790f10 ;wx_woa_app_id 、wx_woa_path和 wx_applet_app_id三者不能同时为空 |
wx_applet_secret | 微信小程序APPID对应的秘钥 | N |
微信实名认证接口:
返参关注字段:
参数 | 中文名 | 必填 | 说明 |
---|---|---|---|
applyment_id | 申请单编号 | String | 微信支付分配的申请单号,申请成功时返回; |
3.2.3 支付宝直连
换取应用授权令牌接口:
入参关注字段:
参数 | 中文名 | 必填 | 说明 |
---|---|---|---|
app_id | 开发者的应用ID | Y | 支付宝分配给开发者的应用ID;示例值:2021001153625042 |
oper_type | 操作类型 | Y | |
app_auth_code | 授权码 | C | 授权码,操作类型为0-换取令牌时必填,其它选填;示例值:123 |
app_auth_token | 应用授权令牌 | C | 应用授权令牌,操作类型为1-刷新令牌时,且该字段有值,将与数据库值进行校验;示例值:202208200312104378 |
申请当面付代签约接口:
入参关注字段
参数 | 中文名 | 必填 | 说明 |
---|---|---|---|
direct_category | 支付宝经营类目 | Y | 示例值:A_A03_4582 ,详情可参考 商家经营类目 中的“经营类目编码” |
app_id | 开发者的应用ID | Y | 支付宝分配给开发者的应用ID;示例值:2021001153625042 |
order_ticket | 订单授权凭证 | N | 订单授权凭证,填写则对应事务提交进入预授权模式;示例值:00ee2d475f374ad097ee0f1ac223fX00 |
sign_and_auth | 签约且授权标识 | N | Y-签约且授权,N-无签约授权;示例值:Y |
account | 商户账号 | Y | isv代操作的商户账号,可以是支付宝账号,也可以是pid(2088开头)示例值:test@alipay.com |
app_auth_token | 应用授权令牌 | N | 详见应用授权概述 |
3.2.4 支付宝间连
AT间连证书登记接口:
参见前文微信间连说明;
4. API列表
类型 | 功能 | 描述 |
---|---|---|
API | 微信商户配置 | 间连模式,微信商户配置 |
API | 微信配置查询 | 间连模式,微信配置查询 |
API | 微信实名认证 | 间连模式,微信实名认证 |
API | 微信实名认证状态查询 | 间连模式,微信实名认证状态查询 |
API | 支付宝实名申请提交 | 间连模式,支付宝实名申请提交 |
API | 支付宝实名申请单查询 | 间连模式,支付宝实名申请单查询 |
API | 证书登记 | 商户直连微信支付宝前需要先登记 |
应用程序接口 | 微信特约商户进件 | 直连模式,微信特约商户进件接口 |
应用程序接口 | 查询微信申请状态 | 直连模式, 微信特约商户进件查询接口 |
应用程序接口 | 修改微信结算帐号 | 直连模式,修改微信结算帐号接口 |
应用程序接口 | 查询微信结算账户 | 直连模式,查询微信结算账户 |
应用程序接口 | 微信关注配置 | 直连模式,微信关注配置 |
应用程序接口 | 微信关注配置查询 | 直连模式,微信关注配置查询 |
应用程序接口 | 换取应用授权令牌 | 支付宝直连,换取应用授权令牌 |
应用程序接口 | 申请当面付代签约 | 支付宝直连,申请当面付代签约 |
应用程序接口 | 查询申请状态 | 支付宝直连-查询申请状态 |
应用程序接口 | 直付通商户入驻 | 支付宝直连直付通产品商户入驻 |
应用程序接口 | 直付通分账关系绑定解绑 | 支付宝直连直付通产品分账关系绑定解绑 |
应用程序接口 | 直付通分账关系查询 | 支付宝直连直付通产品分账关系查询 |