报名费率优惠活动

更新时间：2024.11.18

从业机构可调用该接口帮助已完成开户意愿确认的商户报名微信支付优惠费率活动。

接口说明

支持商户：【从业机构（银行）】　【从业机构（支付机构）】

请求方式：【POST】/v3/rate-activity/applications

请求域名：【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点

　　　　　【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点，指引点击查看

请求参数

Header HTTP头参数

Authorization 　必填　string

请参考签名认证生成认证信息

Accept 　必填　string

请设置为application/json

Content-Type 　必填　string

请设置为application/json

body 包体参数

acquiring_bank_id 　必填 string(32)

【从业机构号】微信支付分配的从业机构唯一标识

channel_id 　必填 string(9)

【渠道商户号】微信支付分配的渠道商唯一标识

sub_mchid 　必填 string(32)

【从业机构特约商户号】

1.请填写已完成开户意愿并且已确认的微信支付子商户号。

2.服务商可通过商户开户确认状态API确认子商户是否已完成开户意愿确认。

activity_detail 　必填 object

【活动报名信息】报名活动信息

属性

activity_id 　必填 string(64)

【活动ID】选择指定活动ID，详细参见《优惠费率活动对照表》。

activity_rate 　选填 string(4)

【活动费率】1、参见《优惠费率活动对照表》。
2、若为固定费率，则无需填写该字段
3、若为区间费率，则由从业机构自定义填写，支持两个小数点，需在优惠费率活动ID指定费率范围内，如0.6%（接口无需传%，只需传数字）

activity_apply_information 　选填 array[object]

【活动报名材料】1、参见《优惠费率活动对照表》，填写活动报名资料。
2、图片上传请填写通过《图片上传API》预先上传图片生成的MediaID。

属性

apply_material_id 　必填 string

【材料ID】根据活动id（activity_id）所选优惠费率活动，参见《优惠费率活动对照表》填写对应的材料ID。

可选取值：：

SCHOOL_QUALIFICATION_PROOF: 学校资质证明
COOPERATION_QUALIFICATION_PROOF: 合作资质证明
ACTIVITY_RATE_COMMITMENT: 优惠费率承诺函
CANTEEN_ENVIRONMENT_PHOTO: 食堂内部用餐环境照片
CANTEEN_FRONT_PHOTO: 食堂门头照片
SCHOOL_LICENSE_PROOF: 办学许可证
QUALIFICATION_PROOF: 机构资质证明
STORE_TENANCY_PROOF: 门店租赁相关证明
STORE_DOOR_PHOTO: 门头照片
FOOD_QUALIFICATION_PROOF: 食品经营相关资质
PARKING_QUALIFICATION_PROOF: 停车场资质证明
PARKINGAREA_PHOTO: 停车场实际经营场景照
MEDICAL_INSTITUTION_PRATICE_LICENSE: 医疗机构执业许可证
HOSPITAL_FRONTDOOR_PHOTO: 医院门头照

apply_material_information 　选填 array[string]

【材料内容】1、根据所选优惠费率活动，在相应材料名称后提供相关材料，详细参见《报名优惠费率活动对照表》。
2、如需上传图片，请填写通过《图片上传API》预先上传图片生成好的MediaID。最多可上传5张图片。
特殊规则：单个MediaID长度限制为255个字节。

additional_information 　选填 object

【补充信息】补充信息

属性

请求示例

POST

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/rate-activity/applications \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Content-Type: application/json" \
6  -d '{
7    "acquiring_bank_id" : "1356485",
8    "channel_id" : "20001111",
9    "sub_mchid" : "1346578",
10    "activity_detail" : {
11      "activity_id" : "SCHOOL_CANTEEN_001",
12      "activity_rate" : "0.6",
13      "activity_apply_information" : [
14        {
15          "apply_material_id" : "SCHOOL_QUALIFICATION_PROOF",
16          "apply_material_information" : [
17            "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo"
18          ]
19        }
20      ]
21    },
22    "additional_information" : {
23      "additional_message" : "特殊情况，说明原因",
24      "additional_material" : [
25        "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo"
26      ]
27    }
28  }'
29

应答参数

200 OK

application_id 　必填 string(32)

【申请单编号】微信支付分配的申请单号。

应答示例

200 OK

1{
2  "application_id" : "20000000011111"
3}
4

错误码

公共错误码

状态码	错误码	描述	解决方案
400	PARAM_ERROR	参数错误	请根据错误提示正确传入参数
400	INVALID_REQUEST	HTTP 请求不符合微信支付 APIv3 接口规则	请参阅接口规则
401	SIGN_ERROR	验证不通过	请参阅签名常见问题
500	SYSTEM_ERROR	系统异常，请稍后重试	请稍后重试

业务错误码

状态码	错误码	描述	解决方案
400	ALREADY_EXISTS	商户提交过报名申请	检查已提交过的申请单结果，再决定下一步操作
400	INVALID_REQUEST	请求参数符合参数格式，但不符合业务规则	根据提示信息，重新检查参数
403	NO_AUTH	商户信息不合法	登录商户平台核对，传入正确信息
404	NOT_FOUND	申请单不存在	请商户检查申请单号是否正确
429	FREQUENCY_LIMITED	频率超限	请求量不要超过接口调用频率限制
500	SYSTEM_ERROR	系统错误	5开头的状态码都为系统问题，请使用相同参数稍后重新调用

文档是否有帮助

更多支持

开发文档(商户)开发文档(V2版)开发者社区微信开放平台微信公众平台腾讯客服