发起交易拦截申诉

更新时间:2025.05.21

通过该接口可发起交易拦截申诉

接口说明

支持商户:【普通服务商】

请求方式:【POST】/v3/transaction-block/transaction-block-submissions/sub-mchid/{sub_mchid}

请求域名:【主域名】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  路径参数

 sub_mchid  必填   string(32)

【子商户号】 由服务商为子商户进件后获取,具体请参考服务商模式开发必要参数说明


body  包体参数

 submit_data  必填   string(4000000)

【商户提交资料内容】 提交资料的内容,基于交易拦截记录查询接口返回的收集资料与加密要求,提交资料内容,具体加密规则请参考资料格式说明文档


 merchant_submit_id  必填   string(128)

【商户侧申诉单号】 商户侧的申诉单号,用于记录和对账

请求示例

curl
Java
Go

POST

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/transaction-block/transaction-block-submissions/sub-mchid/123000110 \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Content-Type: application/json" \
6  -d '{
7    "submit_data" : "{ \t\"record_fields\": [{ \t\t\"item_id\": 100001, \t\t\"name\": \"身份证号\", \t\t\"type\": 1, \t\t\"field_name\": \"FCertCardId\", \t\t\"repeated_field_data\": [\"ri8U5FUSmHh1peGNBUvG+VwGHl31ymiLms5V1yhTbBWUApJDInme1b+ndtrlAielJYpQE41sSxj46ePMto2mySBIJjgCIyChLCTQ580M5pNKglAkjTnXwzJXyPhpyzkpdeFfUDjWc+qd6G4UwrL70br/EEqfQbGNaUKX6jAGjB8wd8wndImMB3iB2vUuAOL+6giLWCBBaC50QRfCTDlGi0c41Gt92tCrRSI7pWzU1cxxJwng7M53/J5PhI+eikLqbhUYlRPHYl6j0ouRItWHCRORYKuz6enluXyFwUCaaR3IeINSM8CwjHp6spnTIo70UaRJWAcZ0jQp/lwX2JVxaw==\"] \t}, { \t\t\"item_id\": 100002, \t\t\"name\": \"门店照片\", \t\t\"type\": 2, \t\t\"field_name\": \"FImages\", \t\t\"repeated_field_data\": [\"xxx1.jpg\"] \t}, { \t\t\"item_id\": 100003, \t\t\"name\": \"身份证照片\", \t\t\"type\": 2, \t\t\"field_name\": \"FImages\", \t\t\"repeated_field_data\": [\"xxx1.jpg\", \"xxx2.jpg\"] \t}, { \t\t\"item_id\": 100004, \t\t\"name\": \"店铺地址\", \t\t\"type\": 3, \t\t\"field_name\": \"FAddRess\", \t\t\"repeated_field_data\": [\"{\\\"longitude\\\":\\\"37.5\\\",\\\"latitude\\\":\\\"123.5\\\",\\\"province\\\":\\\"广东省\\\",\\\"city\\\":\\\"深圳市\\\",\\\"area\\\":\\\"南山区\\\",\\\"street\\\":\\\"XX街道\\\",\\\"address\\\":\\\"XX路XX号\\\",\\\"name\\\":\\\"XXXX公司\\\"}\"] \t}, { \t\t\"item_id\": 100005, \t\t\"name\": \"经营场景\", \t\t\"type\": 4, \t\t\"field_name\": \"FBusinessScenarios\", \t\t\"repeated_field_data\": [\"线上经营\", \"线上线下经营\"] \t}, { \t\t\"item_id\": 100006, \t\t\"name\": \"营业时间\", \t\t\"type\": 4, \t\t\"field_name\": \"FOpeningHours\", \t\t\"repeated_field_data\": [\"09:00:00\", \"20:00:00\"] \t}] }",
8    "merchant_submit_id" : "ABC123456789"
9  }'
10

应答参数

200 OK

 block_submission_id  选填   string(64)

【交易拦截申诉ID】 请求成功时返回,交易拦截申诉记录的主键,唯一定义此资源的标识


 submit_time  选填   string(64)

【提交时间】 请求成功时返回,遵循rfc3339标准格式:yyyy-MM-DDThh:mm:ss+TIMEZONE


 review_result  选填   string

【审核结果】 请求成功时返回,申诉审核结果

可选取值

  • EMPTY:  审核未完成

  • PASS:  业务审核通过

  • REJECT:  业务审核驳回


 review_time  选填   string(64)

【审核时间】 请求成功且审核完成时返回,遵循rfc3339标准格式:yyyy-MM-DDThh:mm:ss+TIMEZONE


 review_reject_reason  选填   string(1024)

【审核驳回原因】 请求成功时返回,审核不通过的原因

应答示例

200 OK

1{
2  "block_submission_id" : "B021234566799876aacsecd",
3  "submit_time" : "2018-06-08T10:34:56+08:00",
4  "review_result" : "EMPTY",
5  "review_time" : "2018-06-08T10:34:56+08:00",
6  "review_reject_reason" : "身份证图片有遮挡,请上传清晰的身份证图片"
7}
8

 

错误码

公共错误码

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误

请根据错误提示正确传入参数

400

INVALID_REQUEST

HTTP 请求不符合微信支付 APIv3 接口规则

请参阅 接口规则

401

SIGN_ERROR

验证不通过

请参阅 签名常见问题

500

SYSTEM_ERROR

系统异常,请稍后重试

请稍后重试

业务错误码

状态码

错误码

描述

解决方案

400

INVALID_REQUEST

此接口仅对部分合作伙伴开放,当前商户号未开放

等待微信支付向当前商户号开放此能力

400

INVALID_REQUEST

该商户下已经存在审核中的申诉单,不允许提交申诉。

请等待申诉审核完成