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

接口说明

支持商户：

【普通商户】

请求方式：

【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

应答参数

200OK
data 选填 array[object]
【上传任务列表】 符合条件的上传任务列表
• 属性
total_count 必填 integer
【总数量】 总数量
offset 必填 integer
【分页页码】 分页页码，页码从0开始
limit 必填 integer
【分页大小】 分页大小

应答示例

200 OK

错误码

公共错误码

状态码	错误码	描述	解决方案
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	系统错误	系统异常，请使用相同参数稍后重新调用