查询上传任务列表

更新时间：2024.11.18

查询号码包中符合条件的上传任务

接口说明

支持商户：【普通服务商】　【从业机构（银行）】　【从业机构（支付机构）】　【清算机构】　【渠道商】

请求方式：【GET】/v3/marketing/bank/packages/{package_id}/tasks

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

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

请求参数

Header HTTP头参数

Authorization 　必填　string

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

Accept 　必填　string

请设置为application/json

path 路径参数

package_id 　必填 string(16)

【号码包id】号码包唯一标识符。可在微信支付商户平台创建号码包后获得。

query 查询参数

filename 　选填 string(128)

【文件名】任务上传的文件名

offset 　选填 integer

【分页页码】分页页码，页码从0开始

limit 　选填 integer

【分页大小】分页大小，单次最多查询20条记录

status 　选填 string

【任务状态】上传任务的状态：PROCESSING - 处理中，FINISHED - 已完成

可选取值：

PROCESSING: 上传任务处理中，请等待

FINISHED: 上传任务已处理完成，任务上传的文件中的用户已导入到号码包中

请求示例

GET

1curl -X GET \
2  https://api.mch.weixin.qq.com/v3/marketing/bank/packages/8473295/tasks?filename=active_user.csv&offset=0&limit=20&status=PROCESSING \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" 
5

应答参数

200 OK

data 　选填 array[object]

【上传任务列表】符合条件的上传任务列表

属性

task_id 　必填 string(16)

【上传任务】上传任务的主键，唯一定义此资源的标识

package_id 　必填 string(16)

【号码包id】号码包唯一标识符。可在微信支付商户平台创建号码包后获得。

filename 　必填 string(128)

【文件名】任务上传的文件名

create_time 　必填 string(32)

【创建上传任务的时间】时间格式采用遵循rfc3339标准格式，格式为YYYY-MM-DDTHH:mm:ss+TIMEZONE，YYYY-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35.+08:00表示，北京时间2015年5月20日 13点29分35秒。

update_time 　选填 string(32)

【上传任务最近一次更新的时间】时间格式采用遵循rfc3339标准格式，格式为YYYY-MM-DDTHH:mm:ss+TIMEZONE，YYYY-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35.+08:00表示，北京时间2015年5月20日 13点29分35秒。

status 　选填 string

【任务状态】上传任务的状态：PROCESSING - 处理中，FINISHED - 已完成

可选取值：

PROCESSING: 上传任务处理中，请等待

FINISHED: 上传任务已处理完成，任务上传的文件中的用户已导入到号码包中

success_count 　选填 integer

【成功数】匹配成功的协议号数。仅当任务状态是FINISHED时，该数据才有效

fail_count 　选填 integer

【失败数】匹配失败的协议号数。仅当任务状态是FINISHED时，该数据才有效

success_user_count 　选填 integer

【匹配成功的微信用户数】匹配成功的微信用户数，不小于匹配成功的协议号数。当一张银行卡被用户绑定到不同微信号时，才可能出现一个协议号对应多个微信账户的情况。仅当任务状态是FINISHED时，该数据才有效

bank_type 　选填 string(32)

【银行类型】银行类型，用于标识协议号所属的银行以及卡类型(信用卡或借记卡)。采用字符串类型的银行标识，值列表详见银行类型

total_count 　必填 integer

【总数量】总数量

offset 　必填 integer

【分页页码】分页页码，页码从0开始

limit 　必填 integer

【分页大小】分页大小

应答示例

200 OK

1{
2  "data" : [
3    {
4      "task_id" : "101",
5      "package_id" : "8473295",
6      "filename" : "active_user.csv",
7      "create_time" : "2020-05-20T13:29:35.120+08:00",
8      "update_time" : "2020-05-20T13:29:35.120+08:00",
9      "status" : "PROCESSING",
10      "success_count" : 1000,
11      "fail_count" : 20,
12      "success_user_count" : 1000,
13      "bank_type" : "ICBC_DEBIT"
14    }
15  ],
16  "total_count" : 20,
17  "offset" : 0,
18  "limit" : 20
19}
20

错误码

公共错误码

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

业务错误码

状态码	错误码	描述	解决方案
400	INVALID_REQUEST	号码包ID未填或格式不正确	URL中的号码包ID错误，请检查
400	INVALID_REQUEST	文件内容为空	请在文件中填充加密后的快捷交易协议号，每行一个，使用\n作换行符，然后再上传
400	INVALID_REQUEST	文件大小超出限制，请分成多个文件上传	文件大小不能超过限制，可分割成若干小文件再上传
400	INVALID_REQUEST	meta和file中的文件名不一致	请参考示例设置请求参数
400	INVALID_REQUEST	基于文件内容计算的sha256与meta传入的sha256不相等	请商户确认文件摘要是否正确计算
400	INVALID_REQUEST	文件的换行符不支持\r\n，请使用\n	请使用\n换行符
400	INVALID_REQUEST	文件不允许存在空行	先删掉空行，再重新上传
400	INVALID_REQUEST	不支持的银行类型，请检查并重试	参考确认银行类型的正确性
400	INVALID_REQUEST	同一号码包不可重复上传同名文件	先确认文件内容是否重复，如果是新内容，请重新命名后上传
400	PARAM_ERROR	HTTP header缺少微信支付平台证书序列号(Wechatpay-Serial)	将加密快捷交易协议号时所使用的平台证书的序列号，设置到HTTP头部的Wechatpay-Serial
404	NOT_FOUND	未找到指定号码包	请商户确认号码包是否由自己创建，只能由创建方导入定向用户协议号
500	SYSTEM_ERROR	系统错误	系统异常，请使用相同参数稍后重新调用

文档是否有帮助

更多支持

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