报名费率优惠活动
更新时间：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
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: 医院门头照
TRADE_QUALIFICATION_PROOF: 外贸资质证明
apply_material_information 选填 array[string] 【材料内容】1、根据所选优惠费率活动，在相应材料名称后提供相关材料，详细参见《报名优惠费率活动对照表》。
2、如需上传图片，请填写通过《图片上传API》预先上传图片生成好的MediaID。最多可上传5张图片。
特殊规则：单个MediaID长度限制为255个字节。 |
|
additional_information 选填 object
【补充信息】补充信息
| 属性 |
| additional_message 选填 string(255) 【补充说明】根据要求提供额外文本信息。
additional_material 选填 array[string(255)] 【补充材料】1、根据要求提供额外补充资料
2、如需上传图片，请填写通过《图片上传API》预先上传图片生成的MediaID，最多可上传5张图片。特殊规则：单个MediaID长度限制为[0,255]个字节。 |
请求示例
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开头的状态码都为系统问题，请使用相同参数稍后重新调用 |
