修改单据信息
更新时间：2024.11.18||
接口说明
支持商户：【从业机构（银行）】 【从业机构（支付机构）】
请求方式：【PATCH】/v3/rate-activity/applications/id/{application_id}
请求域名：【主域名】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
path 路径参数
application_id 必填 string(32)
【申请单编号】微信支付分配的申请单号
body 包体参数
activity_detail_modification 选填 object
【活动报名修改信息】活动报名修改信息
| 属性 |
| activity_rate 选填 string(4) 【活动费率】参见报名《优惠费率活动对照表》，如为固定费率，则该项不需要填写；若为区间费率，需要由从业机构自定义填写，支持两个小数点，需在优惠费率活动ID指定费率范围内，如0.6%（接口无需传%，只需传数字）
activity_apply_information 选填 array[object] 【活动报名材料】参见报名《优惠费率活动对照表》，填写报名活动所需资质信息。图片上传请填写通过《图片上传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]个字节。 |
请求示例
PATCH
1curl -X PATCH \
2 https://api.mch.weixin.qq.com/v3/rate-activity/applications/id/20000011111 \
3 -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4 -H "Accept: application/json" \
5 -H "Content-Type: application/json" \
6 -d '{
7 "activity_detail_modification" : {
8 "activity_rate" : "0.6",
9 "activity_apply_information" : [
10 {
11 "apply_material_id" : "SCHOOL_QUALIFICATION_PROOF",
12 "apply_material_information" : [
13 "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo"
14 ]
15 }
16 ]
17 },
18 "additional_information" : {
19 "additional_message" : "特殊情况，说明原因",
20 "additional_material" : [
21 "0P3ng6KTIW4-Q_l2FjKLZuhHjBWoMAjmVtCz7ScmhEIThCaV-4BBgVwtNkCHO_XXqK5dE5YdOmFJBZR9FwczhJehHhAZN6BKXQPcs-VvdSo"
22 ]
23 }
24 }'
25应答参数
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开头的状态码都为系统问题，请使用相同参数稍后重新调用 |
