微信支付合作伙伴平台

接口说明

适用对象：服务商

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

请求主体类型：multipart/form-data

请求方式：POST

path 指该参数为路径参数

query 指该参数需在请求URL传参

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

请求参数

各语言请求示例

---示例代码待更新---

返回参数

返回示例

{
  "bank_type": "ICBC_DEBIT",
  "create_time": "2020-05-20T13:29:35+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+08:00"
}
                    

http://2323weixin.qq.com
                    

请求步骤

快捷交易协议号文件格式说明

快捷交易协议号文件内容需要遵循特定格式，才能够正确解析和识别为微信用户。

格式说明：

1、为保证数据安全，快捷交易协议号需要加密后上传。加密方法可参考敏感信息加解密，使用微信支付平台证书中的公钥，逐个加密快捷交易协议号。

2、文件内容：每行一个加密后的快捷交易协议号，换行符使用\n，不能使用\r\n，不允许包含空行。

3、文件大小不能超过2MB，建议单个文件的行数不超过5500行。

文件上传步骤：

1.创建一个POST的方法请求/upload URI

例如： POST https://api.mch.weixin.qq.com/v3/marketing/bank/packages/{package_id}/tasks HTTP/1.1

2.将文件的数据添加到请求主体

2.1 文本文件file参数的获取方式说明：
文本文件二进制内容，放在请求http的body中。

2.2 文本文件元信息meta参数的获取方式说明：
文本文件元信息，使用json表示，包含三个对象：bank_type、filename、sha256。
● bank_type参数获取方式说明：
银行类型，用于标识协议号所属的银行以及卡类型(信用卡或借记卡)。采用字符串类型的银行标识，值列表详见银行类型
● filename参数获取方式说明：
快捷协议号包文件名。可包含英文字母，数字，_，.，-等内容，不允许出现其他不合法符号。同一个号码包的多个上传任务的文件名不可重复，要保证唯一
● sha256参数获取方式说明：
快捷交易协议号文件的文件摘要，即快捷交易协议号文件的二进制内容进行sha256计算得到的值

2.3 签名计算说明：
签名生成
参与签名计算的请求主体为meta的json串：
{ "bank_type": "ICBC_DEBIT","filename": "active_user.csv", "sha256": "hjkahkjsjkfsjk78687dhjahdajhk" }

待签名串示例：

POST
/v3/marketing/bank/packages/{package_id}/tasks
1566987169           //时间戳
12ced2db6f0193dda91ba86224ea1cd8   //随机数
{ "bank_type": "ICBC_DEBIT","filename": "active_user.csv", "sha256": "hjkahkjsjkfsjk78687dhjahdajhk" }

3.添加HTTP头：

Content-Type：multipart/form-data.设置为要上载的对象的MIME媒体类型。
Authorization: WECHATPAY2-SHA256-RSA2048 mchid="1900231671",
nonce_str="PCHK6HSOEDTACETP6P3AL7DWPHTBKIAT",timestamp="1567067659",
serial_no="1FB89742D19F2BD30B69948D16DECA0FCB4481EB",
signature="PB6M7+3JL7TSCl5zqD1sdWVypOIEQsD4dgOU+vPiVM6GMRo2qYSWKf8u46i9ZJFhyZTBdZ7SFR+BjDZh6
89hFgN8LZL+QWTvq3cse/FEUFYyOLN7L/2IZX4GA4cWInuJ2MpOhZRMpm+emrcn42gTMKAPNQ7dBLO7ux6MoSuQp69
PW+p1ogmkER68exTVUXYqA5P3vITlWNr++RDy2+ExvB7qVISOKW0vBkxUxN9e7hwUbDwGln170ZXomoO1KpQSbw3f1u
WUCx/IlWJhJIun7rUMtVT+kfijNUqcILtSfE4hWKKVaZn9j5CX8M7aKbbDOFy3SvbSJ3WQgRnRbgog5w=="
Content-Type: multipart/form-data;boundary=boundary

4.添加body：

// 以下为body的内容
--boundary  // boundary为商户自定义的一个字符串
Content-Disposition: form-data; name="meta";
Content-Type: application/json
//此处必须有一个空行
{ "bank_type": "ICBC_DEBIT","filename": "active_user.csv", "sha256": "hjkahkjsjkfsjk78687dhjahdajhk" }
--boundary
Content-Disposition: form-data; name="file"; filename="active_user.csv";
Content-Type: text/plain
//此处必须有一个空行
cvs  //cvs即为快捷交易协议号文件的二进制内容
--boundary--

说明：请求包体每行结尾都需要包含\r\n（空行也需要）。

5.发送请求

POST /v3/marketing/bank/packages/{package_id}/tasks HTTP/1.1
Host: api.mch.weixin.qq.com
Authorization: WECHATPAY2-SHA256-RSA2048 
mchid="1900231671",nonce_str="PCHK6HSOEDTACETP6P3AL7DWPHTBKIAT",
timestamp="1567067659",
serial_no="1FB89742D19F2BD30B69948D16DECA0FCB4481EB",
signature="PB6M7+3JL7TSCl5zqD1sdWVypOIEQsD4dgOU+vPiVM6GMRo2qYSWKf8u46i9ZJFhyZTBdZ7
SFR+BjDZh689hFgN8LZL+QWTvq3cse/FEUFYyOLN7L/2IZX4GA4cWInuJ2MpOhZRMpm+emrcn42gTMKAPN
Q7dBLO7ux6MoSuQp69PW+p1ogmkER68exTVUXYqA5P3vITlWNr++RDy2+ExvB7qVISOKW0vBkxUxN9e
7hwUbDwGln170ZXomoO1KpQSbw3f1uWUCx/IlWJhJIun7rUMtVT+kfijNUqcILtSfE4hWKKVaZn9j5CX8M
7aKbbDOFy3SvbSJ3WQgRnRbgog5w=="
Content-Type: multipart/form-data;boundary=boundary

--boundary  
Content-Disposition: form-data; name="meta";
Content-Type: application/json

{ "bank_type": "ICBC_DEBIT","filename": "active_user.csv", "sha256": "hjkahkjsjkfsjk78687dhjahdajhk" }
--boundary
Content-Disposition: form-data; name="file"; filename="active_user.csv";
Content-Type: text/plain

cvs
--boundary--

错误码公共错误码