商户活动报名
最近更新时间：2023.7.24
1. 产品介绍
1.1 简介
活动是指商户参加微信、支付宝组织的优惠活动，商户通过斗拱可以直接参加这些优惠活动。目前只支持微信、支付宝的活动。
AT优惠活动相关政策及报名材料
下载材料说明表格
业务流程图：
1.2 应用场景
商户希望参加由第三方组织的政策活动，获得优惠的手续费率等。
2. 接入前准备
2.1业务开通及配置
斗拱支持在控台上操作商户活动报名与接口参加活动报名。控台操作参见《商户活动报名-控台操作》。
以下只对要做活动报名的商户做相关接口传参时候的特殊说明。 商户进件、入驻、实名认证相关操作请参考正常商户进件、业务入驻、实名认证流程的说明。
2.2 对接准备
第一步：密钥获取
联调之前需要先获取公私钥，参见公私解钥参数获取说明；
第二步：公共参数获取
登录服务商/商户控台后，可在开发设置-开发者信息中，获取sys_id，product_id参数信息;
3. 开发指引
3.1 对接规范
调用汇付接口，均采取POST形式提交，数据格式统一为JSON格式，相关SDK及签名方法见链接：
SDK示例：Java 开发工具包
加签验签：v2版接口加签验签
3.2 确认业务配置
3.3 系统接口说明
3.3.1 商户进件
由于微信、支付宝的活动通常有行业或商户类型的限制，这些是商户进件时就确定的。
企业商户基本信息入驻接口
请求参数关注以下字段：
| 参数 | 中文名 | 是否必填 | 说明 |
|---|---|---|---|
| ent_type | 公司类型 | 是 | 见表格 |
| mcc | 所属行业 | 是 | 见表格 |
3.3.2 商户业务入驻
商户业务开通接口
请求参数关注以下字段：
| 参数 | 中文名 | 是否必填 | 说明 |
|---|---|---|---|
| +wx_conf_list | 微信配置对象 | ||
| pay_scene | 支付场景 | 是 | 见表格 |
| fee_rule_id | 费率规则id | 可选 | 如在进件时mcc已传入准确的mcc，此处无需上传； 如在进件时mcc未正确填写参考表格； |
| +ali_conf_list | 支付宝配置对象 | ||
| pay_scene | 支付场景 | 是 | 1-线上扫码 |
| mcc | 商户经营类目 | 可选 | 如在进件时mcc已传入准确的mcc，此处无需上传； 如在进件时mcc未正确填写，此处填写参考表格； |
3.3.3 商户微信支付宝实名认证
微信实名认证接口、支付宝实名申请提交
此处无特殊说明，按照正常流程完成微信/支付宝实名认证即可。
3.3.4 商户活动报名
商户活动报名（微信/支付宝）
1） 请求参数关注如下字段：
| 参数 | 中文名 | 必填 | 说明 |
|---|---|---|---|
| fee_type | 手续费类型 | 是 | 按照商户实际入驻时候的类型上送： 1-标准费率线上 2-标准费率线下 3-非盈利费率，支付宝支持（如公办医院等） 7-校园餐饮，微信、支付宝都支持 9-非在线教培，只有微信支持； |
| pay_way | 支付通道 | 是 | 按照实际报名活动的通道选择 W-微信，A-支付宝 |
| activity_type | 活动类型 | 是 | education_001 线下教培机构 school_canteen_002 教育行业学校主体食堂 campus_dining_001 教育行业非学校主体食堂 parking_001 停车缴费行业活动 private_healthcare_001 商业医疗行业活动 |
注：
-
以上具体对应关系及所需上送证照图片参考表格；
-
其它说明：商户活动报名提交后，可通过商户活动报名查询（微信/支付宝）接口，查询活动报名结果，确认活动报名成功后，需要再调用商户业务开通修改接口，修改商户交易手续费费率，其中请求参数pay_scene支付场景同之前业务开通时上传。
3.3.5 商户业务开通修改
当商户入驻时候的经营范围不正确，可能导致商户无法做商户活动报名，或在后续交易过程中碰到微信支付宝的风险管控提醒，此时商户需做经营范围的修改，可通过渠道商控台发起修改或通过调用接口进行修改。
请求参数关注如下字段：
| 参数 | 中文名 | 是否必填 | 说明 |
|---|---|---|---|
| +wx_conf_list | 微信配置对象 | ||
| fee_rule_id | 费率规则id | 可选 | 见表格 |
| +ali_conf_list | 支付宝配置对象 | ||
| MCC公司 | 商户经营类目 | 可选 | 见表格 |
4. API列表
| 类型 |
接口名称
|
描述 |
|---|---|---|
|
应用程序接口
|
企业商户基本信息入驻 | 服务商通过此接口在汇付为企业类商户进行基本信息开户。传入企业商户基本资料和图片资料，开通汇付账号，为商户绑定银行卡、配置结算和取现等功能。若选择发送短信给商户，汇付将会以短信方式发送账号、密码、控台地址至商户联系人手机号。 |
| 应用程序接口 | 商户业务开通 | 商户进件成功后开通支付方式、业务功能、配置费率；会触发签约流程。 |
| 应用程序接口 | 商户业务修改 | 修改商户的业务配置，包括支付方式、业务功能、手续费率，可能会触发签约流程。 |
| 应用程序接口 | 微信实名认证 | 商户在微信侧进行实名认证 |
| 应用程序接口 | 支付宝实名申请提交 | 商户在支付宝侧进行实名认证 |
| 应用程序接口 | 商户活动报名（微信/支付宝） | 商户报名参与微信、支付宝的政策活动 |
| 应用程序接口 | 商户活动报名查询（微信/支付宝） | 商户报名活动查询 |
