接口說明

適用對(duì)象：服務(wù)商

請(qǐng)求URL：https://api.mch.weixin.qq.com/v3/marketing/bank/packages/{package_id}/tasks

請(qǐng)求主體類型：multipart/form-data

請(qǐng)求方式：POST

path 指該參數(shù)為路徑參數(shù)

query 指該參數(shù)需在請(qǐng)求URL傳參

body 指該參數(shù)需在請(qǐng)求JSON傳參

請(qǐng)求參數(shù)

各語言請(qǐng)求示例

---示例代碼待更新---

返回參數(shù)

返回示例

{
  "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
                    

請(qǐng)求步驟

快捷交易協(xié)議號(hào)文件格式說明

快捷交易協(xié)議號(hào)文件內(nèi)容需要遵循特定格式，才能夠正確解析和識(shí)別為微信用戶。

格式說明：

1、為保證數(shù)據(jù)安全，快捷交易協(xié)議號(hào)需要加密后上傳。加密方法可參考敏感信息加解密，使用微信支付平臺(tái)證書中的公鑰，逐個(gè)加密快捷交易協(xié)議號(hào)。

2、文件內(nèi)容：每行一個(gè)加密后的快捷交易協(xié)議號(hào)，換行符使用\n，不能使用\r\n，不允許包含空行。

3、文件大小不能超過2MB，建議單個(gè)文件的行數(shù)不超過5500行。

文件上傳步驟：

1.創(chuàng)建一個(gè)POST的方法請(qǐng)求/upload URI

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

2.將文件的數(shù)據(jù)添加到請(qǐng)求主體

2.1 文本文件file參數(shù)的獲取方式說明：
文本文件二進(jìn)制內(nèi)容，放在請(qǐng)求http的body中。

2.2 文本文件元信息meta參數(shù)的獲取方式說明：
文本文件元信息，使用json表示，包含三個(gè)對(duì)象：bank_type、filename、sha256。
● bank_type參數(shù)獲取方式說明：
銀行類型，用于標(biāo)識(shí)協(xié)議號(hào)所屬的銀行以及卡類型(信用卡或借記卡)。采用字符串類型的銀行標(biāo)識(shí)，值列表詳見銀行類型
● filename參數(shù)獲取方式說明：
快捷協(xié)議號(hào)包文件名。可包含英文字母，數(shù)字，_，.，-等內(nèi)容，不允許出現(xiàn)其他不合法符號(hào)。同一個(gè)號(hào)碼包的多個(gè)上傳任務(wù)的文件名不可重復(fù)，要保證唯一
● sha256參數(shù)獲取方式說明：
快捷交易協(xié)議號(hào)文件的文件摘要，即快捷交易協(xié)議號(hào)文件的二進(jìn)制內(nèi)容進(jìn)行sha256計(jì)算得到的值

2.3 簽名計(jì)算說明：
簽名生成
參與簽名計(jì)算的請(qǐng)求主體為meta的json串：
{ "bank_type": "ICBC_DEBIT","filename": "active_user.csv", "sha256": "hjkahkjsjkfsjk78687dhjahdajhk" }

待簽名串示例：

POST
/v3/marketing/bank/packages/{package_id}/tasks
1566987169           //時(shí)間戳
12ced2db6f0193dda91ba86224ea1cd8   //隨機(jī)數(shù)
{ "bank_type": "ICBC_DEBIT","filename": "active_user.csv", "sha256": "hjkahkjsjkfsjk78687dhjahdajhk" }

3.添加HTTP頭：

Content-Type：multipart/form-data.設(shè)置為要上載的對(duì)象的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的內(nèi)容
--boundary  // boundary為商戶自定義的一個(gè)字符串
Content-Disposition: form-data; name="meta";
Content-Type: application/json
//此處必須有一個(gè)空行
{ "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
//此處必須有一個(gè)空行
cvs  //cvs即為快捷交易協(xié)議號(hào)文件的二進(jìn)制內(nèi)容
--boundary--

說明：請(qǐng)求包體每行結(jié)尾都需要包含\r\n（空行也需要）。

5.發(fā)送請(qǐng)求

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--

錯(cuò)誤碼公共錯(cuò)誤碼