微信支付-银行定向活促

返回上一层文档首页 / 查询上传任务列表API

查询上传任务列表API

最新更新时间：2021.09.23 版本说明

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

注意：

• 商户上送敏感信息时使用微信支付平台公钥加密，证书序列号包含在请求HTTP头部的Wechatpay-Serial，详见接口规则

接口说明

适用对象： 直连商户

请求URL：https://api.mch.weixin.qq.com/v3/marketing/bank/packages/{package_id}/tasks

请求方式：GET

path 指该参数为路径参数

query 指该参数为URL参数

body 指该参数需在请求JSON传参

请求参数

参数名	变量	类型[长度限制]	必填	描述
号码包id	package_id	string[4, 16]	是	path号码包唯一标识符。可在微信支付商户平台创建号码包后获得。示例值：8473295
任务状态	status	string	否	query上传任务的状态： PROCESSING：处理中， FINISHED：已完成示例值：PROCESSING
文件名	filename	string[4, 128]	否	query任务上传的文件名示例值：active_user.csv
分页页码	offset	int	否	query分页页码，页码从0开始示例值：0
分页大小	limit	int	否	query分页大小，单次最多查询20条记录示例值：20

请求示例


https://api.mch.weixin.qq.com/v3/marketing/bank/packages/8473295/tasks?status=PROCESSING&filename=active_user.csv&offset=0&limit=20


｛
JAVA示例代码
｝

返回参数

参数名

变量

类型[长度限制]

必填

描述

+ 上传任务列表

data

array

是

符合条件的上传任务列表

参数名	变量	类型[长度限制]	必填	描述
上传任务	task_id	string[1, 16]	是	上传任务的主键，唯一定义此资源的标识示例值：101
号码包id	package_id	string[4, 16]	是	号码包唯一标识符。可在微信支付商户平台创建号码包后获得。示例值：8473295
文件名	filename	string[4, 128]	是	任务上传的文件名示例值：active_user.csv
创建上传任务的时间	create_time	string[8, 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秒。示例值：2020-05-20T13:29:35.120+08:00
上传任务最近一次更新的时间	update_time	string[8, 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秒。示例值：2020-05-20T13:29:35.120+08:00
任务状态	status	string	否	上传任务的状态： PROCESSING：处理中，上传任务处理中，请等待 FINISHED：已完成，上传任务已处理完成，任务上传的文件中的用户已导入到号码包中示例值：PROCESSING
成功数	success_count	int	否	匹配成功的协议号数。仅当任务状态是FINISHED时，该数据才有效示例值：1000
失败数	fail_count	int	否	匹配失败的协议号数。仅当任务状态是FINISHED时，该数据才有效示例值：20
匹配成功的微信用户数	success_user_count	int	否	匹配成功的微信用户数，不小于匹配成功的协议号数。当一张银行卡被用户绑定到不同微信号时，才可能出现一个协议号对应多个微信账户的情况。仅当任务状态是FINISHED时，该数据才有效示例值：1000
银行类型	bank_type	string[1, 32]	否	银行类型，用于标识协议号所属的银行以及卡类型(信用卡或借记卡)。采用字符串类型的银行标识，值列表详见银行类型示例值：ICBC_DEBIT

总数量

total_count

int

是

总数量
示例值：20

分页页码

offset

int

是

分页页码，页码从0开始
示例值：0

分页大小

limit

int

是

分页大小
示例值：20

返回示例

正常示例


{
  "data": [
    {
      "bank_type": "ICBC_DEBIT",
      "create_time": "2020-05-20T13:29:35.120+08:00",
      "fail_count": 20,
      "filename": "active_user.csv",
      "package_id": "8473295",
      "status": "PROCESSING",
      "success_count": 1000,
      "success_user_count": 1000,
      "task_id": "101",
      "update_time": "2020-05-20T13:29:35.120+08:00"
    }
  ],
  "limit": 20,
  "offset": 0,
  "total_count": 20
}


http://2323weixin.qq.com

错误码公共错误码

状态码	错误码	描述	解决方案
400	INVALID_REQUEST	号码包id未填或格式不正确	url中的号码包id错误，请检查
404	NOT_FOUND	未找到指定号码包	请商户确认号码包是否由自己创建，只能由创建方导入定向用户协议号
500	SYSTEM_ERROR	系统错误	系统异常，请使用相同参数稍后重新调用

技术咨询

文档反馈

微信支付商户平台