完结小说排行榜,小说排行榜完结版

閱讀對象

該文檔面向開發(fā)工程師，研發(fā)工程師，測試工程師，系統(tǒng)運維工程師。

開發(fā)人員請仔細閱讀商務接入流程、簽名機制、API列表、交易返回碼。

商務接入流程

一.商戶準備資料

企業(yè)營業(yè)執(zhí)照	法人身份證（正反面）	組織機構代碼證
開許戶可證	稅務登記證	租賃合同/房屋產權證明
法人對私銀行卡（非必交）	ICP許可證	辦公前臺（帶logo）/辦公區(qū)域照片
其它相關資質（SP證、網絡文化經營許可證）（非必交）

注：
1、無卡產品需簽訂《中茂恒潤支付合作業(yè)務承諾函》、其它產品需簽訂《中茂恒潤支付合作業(yè)務告知函》。
2、所有文件一式兩份，均需加蓋公章和騎縫章。

二.簽署協議

簽署合作協議，約定業(yè)務產品、費率、結算周期，繳納保證金。
注：
1、所需簽署協議：《中茂恒潤代收付協議》、《中茂恒潤技術服務協議（互聯網支付）》。
2、商戶接入微信、支付寶需要進行報件，詳見[ 報件流程 ]。

三.技術對接聯調

提供開發(fā)文檔、測試參數，專業(yè)團隊提供技技術支持，配合接口對接聯調。
注：前往下載中心下載文檔、demo，里面包含測試參數，調試接口時結合文檔及demo。

四.開通生產商戶號和產品

1、測試環(huán)境測試通過后，前往下載中心下載《開戶信息表》，填寫完成后，發(fā)送至service@zhongmaopay.com。
2、獲取生產商戶號后，自行登錄商戶后臺下載證書，替換測試環(huán)境的證書，同時注意替換通訊地址（詳見接口規(guī)則、通訊）。

五.上線運營

正式上線運營，專人負責上線后的維護，業(yè)務監(jiān)控，保證業(yè)務通暢。

微信和支付寶子商戶進件

一、微信子商戶進件說明

（一）、商戶到微信公眾平臺 https://mp.weixin.qq.com/ 以企業(yè)主體注冊微信服務號，需對公打款進行驗證和開發(fā)者資質認證，獲取APPID。
（二）、驗證通過，填寫進件表格，發(fā)送至service@zhongmaopay.com，郵件主題備注與中茂簽約主體的公司名稱。
1、上傳模板參數說明

項目	說明
商戶名稱	商戶必須具有認證公眾號的商戶公司主體的工商注冊名稱，提交的時候請參考如下核驗公眾號帳號主體，用于申請注冊商戶。例如：特別說明：所提供的商戶名稱必須與下面的子商戶公眾號APPID一致，比如這里我們提供的帳號主體是“中國民生銀行股份有限公司廣州分行”，則我們在下面的子商戶公眾號APPID也必須是以中國民生銀行股份有限公司廣州分行”為帳號主體的公眾號的appid
商戶簡稱(必填)	填寫商戶名稱的摘要簡稱，用戶出現在c端用戶支付界面上，可以自定義商戶簡稱比如品牌名稱或者店鋪名稱，以便提高持卡人的辨識度降低投訴。嚴禁寫入其他銀行名稱作為簡稱！
是否使用民生受理公眾號（取值 'Y'或'N'）	默認取值：'N'。
受理公眾號ID （必填）	wx5d236520a4bf0eaa
子商戶公眾號 ID（必填）	需準確填寫商戶名稱對應主體的公眾號APPID,在使用公眾號支付等，需傳入子商戶以下對應類型的APPID，以獲取 sub_openid。特別說明： 1.檢查公眾號主體是否與商戶名稱一致 2.獲取方式：登錄mp.weixin.qq.com 查看：【開發(fā)】->【基本配置】
支付授權目錄（必填）	所有使用js api方式發(fā)起支付請求的鏈接地址，都必須在支付授權目錄之下；最多設置3個支付授權目錄，且域名必須通過icp備案，使用多個時，要求使用”\|“分隔。頭部要包含http或https，須細化到二級或三級目錄，以左斜杠“/”結尾。特別說明：結尾必須是左斜杠“/”結尾的目錄，不能是具體到某個頁面
經營類目ID （必填）	請參照類目指引的文檔，填寫商戶的對應的類目ID，注意市場價為非0.6%或特定行業(yè)的時候，會引起費率的套用及結算時間問題，謹慎選擇。特殊商戶，特殊選擇。
客服電話（必填）	準座機需填寫區(qū)號，如有分機也一并填寫，例如：0755-8376777-0000，客服電話請保持暢通，否則影響你的服務質量和被客戶直接投訴到微信，建議填寫商家的客服電話。
聯系人（必填）	雖為非必填，但是要求填，微信支付將會第一時間聯系該負責人，在差錯處理、客戶投訴的時候，微信支付會使用。建議填寫服務商自己的聯系方式
聯系手機（必填）	注意填寫手機號碼格式，要求純數字，否則報錯，必須能夠聯系到的服務商客服人員。
聯系郵箱（必填）	雖為非必填，但是要求填，在差錯處理、客戶投訴的時候，微信支付會使用。建議填寫服務商的。
渠道類型（必填，取值 'WEIXIN'或 'ALIPAY'）	WEIXIN（目前批量進件子商戶只有微信支付）
聯系人微信賬號（必填，聯系人微信號）	必須填寫聯系人真實的微信號，如不一致，會導致配置不通過。

2、報備通過后，對應生成民生子商戶號。
民生子商戶號：在民生系統(tǒng)內的子商戶標識，用于【統(tǒng)一支付接口】下單的subChnlMerNO。

二、支付寶子商戶進件

（一）、商戶到支付寶開發(fā)平臺 https://open.alipay.com/platform/home.htm 以企業(yè)主體進行注冊，需對公打款進行驗證，獲取PID。
（二）、驗證通過之后，填寫進件表格，發(fā)至service@zhongmaopay.com ，郵件主題備注與中茂簽約主體的公司名稱。
（三）、M1-M3級支付寶子商戶等級定義：

1、 M1級商戶屬于可正常交易的子商戶，即商戶入駐信息為受理商戶真實信息；
2、 M2級商戶有機會使用花唄支付、商家自運營（支付即會員）等功能。需要在M1級商戶基礎之上補充商戶地址信息；
3、 M3級商戶除了可以享受M2級間連商戶的權益外，還有機會使用花唄分期、獲得支付寶風控黑名單能力、參加支付寶權益日等功能。需在M2級商戶基礎之上補充營業(yè)執(zhí)照信息和結算卡信息。

（四）、子商戶進件說明：

填寫步驟如下，請?zhí)顚懲暾腗1（必填）標識項目內容；M2和M3級建議填寫。
i. 商戶名稱（M1）（必填）
ii. 商戶簡稱（M1）（必填）
iii.客服電話（M1）（必填）
iv. 經營類目ID（M1）（必填）：下拉選，政府/社會組織，專業(yè)銷售/批發(fā)，醫(yī)療健康，愛車，教育培訓，超市便利店，航旅，生活服務，休閑娛樂，購物，美食
v. 是否使用民生pid：選擇否
vi. 受理商戶來源機構標識（pid）使用民生pid時候留空，不使用民生pid時必填，請?zhí)顚懀?088XXXXXXXX2932， 208開的16位PID。【不可以使用個人名義的PID進行進件】
vii. 聯系人名稱（M1）（必填）
viii.聯系人電話（M1）（必填）純數字，不帶符號，建議填寫服務商自己的員工；支付寶會聯系差錯交易
ix. 聯系人手機（M1）（必填）純數字，不帶符號，建議填寫服務商自己的員工，支付寶會聯系差錯交易
x. 聯系人郵箱（M1）（必填）建議填寫服務商自己的員工，支付寶會聯系差錯交易
xi. 聯系人類型（M1）下拉選擇聯系人類型：其他，法人，實際控制人，代理人
xii.身份證號（M1），上述聯系人對應的身份證號碼
由于后續(xù)支付寶所有獎勵金、花唄等獎勵，均需商戶是M2級及以上級別（M3），請商戶盡量在填完M1之外，將M2、M3的內容也進行填寫。
i. 省份（M2）：下拉選擇，例如廣東省
ii. 城市（M2）：下拉選擇，例如廣州市
iii. 區(qū)縣（M2）：下拉選擇，例如天河區(qū)
iv. 地址類型（M2）: 下拉選擇類型：注冊地址或經營地址
v. 經營地址（M2）：商家詳細的經營地址。
vi. 營業(yè)執(zhí)照類型（M3）：營業(yè)執(zhí)照（多證合一），營業(yè)執(zhí)照，事業(yè)單位法人證書
vii. 營業(yè)執(zhí)照編號（M3）：填寫對應的營業(yè)執(zhí)照編號
viii. 銀行卡持卡人姓名（M3）
ix. 銀行卡號（M3）
x. 支付寶帳戶和支付二維碼信息（可留空）

（五）、支付寶報建數據字典解讀：

批量子商戶模版中，對應的地區(qū)編碼，地址類型，營業(yè)執(zhí)照類型，聯系人類型，經營類目，對應的數字和字符。

（六）、批量“子商戶進件”填寫說明（附了兩個案例說明）,填寫步驟如下，請?zhí)顚懲暾腗1（必填）標識項目內容；M2建議填寫，M3級請選填。 i. 商戶名稱（M1）（必填）
ii.商戶簡稱（M1）（必填）
iii.客服電話（M1）（必填）
iv.經營類目（M1）（必填）：請在報建字典中查詢對應的經營類目數值，前綴ID，如美食對應的編碼為2015050700000000，則該項填寫為ID2015050700000000；
v.是否使用民生pid：選擇是或者否，實體商戶請選擇是
vi.受理商戶來源機構標識（pid）（使用民生pid時候留空，不使用民生pid時必填，請?zhí)顚懀?088XXXXXXXX2932， 208開的16位PID。聯系人名稱（M1）（必填）
vii.聯系人電話（M1）（純數字，不帶符號，必填，建議填寫服務商自己的員工；支付寶會聯系差錯交易）
viii.聯系人手機（M1）（必填，純數字，不帶符號，建議填寫服務商自己的員工，支付寶會聯系差錯交易）
ix.聯系人郵箱（M1）：必填，建議填寫服務商自己的員工，支付寶會聯系差錯交易
x.聯系人類型（M1）：請在報建字典中聯系人類型對應的數值，如聯系人為企業(yè)法人，則此項填寫LEGAL_PERSON；
xi.身份證號（M1）：上述聯系人對應的身份證號碼，前綴ID，如客戶身份證號碼123456789012345，則此項填寫ID123456123456789012345；

由于后續(xù)支付寶所有獎勵金、花唄等獎勵，均需商戶是M2級及以上級別（M3），請商戶盡量在填完M1之外，將M2、M3級的內容也進行填寫。
i.省份（M2）：請在報建字典中省份對應的編碼
ii.城市（M2）：請在報建字典中城市對應的編碼
iii.區(qū)縣（M2）：請在報建字典中區(qū)縣編碼，例如石門溝區(qū)，區(qū)縣填寫110109（對應字典的地區(qū)編碼），城市為北京市110100，省份為北京110000；
iv.地址類型（M2）: 請在報建字典中地址類型對應的數值，例如，經營地址，填寫B(tài)USINESS_ADDRESS
v.經營地址（M2）：填寫商家詳細的經營地址。
vi.營業(yè)執(zhí)照類型（M3）：營業(yè)執(zhí)照（多證合一），營業(yè)執(zhí)照，事業(yè)單位法人證書
vii.營業(yè)執(zhí)照編號（M3）：填寫對應的營業(yè)執(zhí)照編號
viii.銀行卡持卡人姓名（M3）
ix.銀行卡號（M3）：請前綴ID

微信掃碼支付

場景：用戶掃描商家展示的二維碼進行支付

步驟一：打開微信，點擊掃一掃。圖-1
步驟二：商家展示二維碼，用戶掃描二維碼。圖-2，圖-3

圖-1
圖-2
圖-3

步驟三：用戶點擊確認支付，前往支付。圖-4
步驟四：輸入密碼，進行支付。圖-5
步驟五：完成支付，提示支付成功。圖-6

圖-4
圖-5
圖-6

微信刷卡（反掃）

場景：商家掃描用戶的二維碼進行支付

步驟一：打開微信，點擊收付款。圖-1
步驟二：向商家展示付款二維碼，供商家掃碼。圖-2
步驟三：商家掃碼成功，提示用戶支付成功。圖-3

圖-1
圖-2
圖-3

支付寶掃碼支付

場景：用戶掃描商家展示的二維碼進行支付

步驟一：打開支付寶，點擊掃一掃。圖-1
步驟二：商家展示二維碼，用戶掃描二維碼。圖-2，圖-3

圖-1
圖-2
圖-3

步驟三：用戶點擊立即支付，進行指紋支付（輸入支付密碼）。步驟四：完成支付，提示支付成功。

圖-4
圖-5

支付寶刷卡支付

場景：商家掃描用戶的二維碼進行支付

步驟一：打開支付寶，點擊付錢。圖-1
步驟二：向商家展示付款二維碼，供商家掃碼。圖-2
步驟三：商家掃碼成功，提示用戶支付成功。圖-3

圖-1
圖-2
圖-3

京東掃碼支付

場景：用戶掃描商家展示的二維碼進行支付

步驟一：打開京東金融APP。圖-1
步驟二：點擊掃一掃，掃描二維碼。圖-2-1，圖-2-2

圖-1
圖-2-1
圖-2-2

步驟三：用戶輸入密碼，進行交易。圖-3
支付完成，提示用戶支付成功。圖-4

圖-3
圖-4

京東付款碼支付

場景：商家掃描用戶的二維碼進行支付

步驟一：打開京東金融APP。圖-1
步驟二：點擊付款，向商家展示付款二維碼，供商家掃碼。圖-2
商家掃碼成功，提示用戶支付成功。圖-3

圖-1
圖-2
圖-3

QQ錢包掃碼支付

場景：用戶掃描商家展示的二維碼進行支付

步驟一：打開QQ，點擊掃一掃。圖-1
步驟二：掃描二維碼。圖-2
步驟三：用戶點擊立即支付，前往支付。

圖-1
圖-2
圖-3

步驟四：輸入密碼，進行支付。
步驟五：完成支付，提示支付成功。

圖-4
圖-5

QQ錢包付款碼支付

場景：商家掃描用戶的二維碼進行支付

步驟一：打開QQ，點擊QQ錢包。圖-1
步驟二：點擊付款，向商家展示付款二維碼，供商家掃碼。圖-2
步驟三：商家掃碼成功，提示用戶支付成功。圖-3

圖-1
圖-2
圖-3

網銀B2

場景：持卡人在商戶網站B2C購物支付場景，持卡人通過點擊銀聯在線支付圖標，并跳轉銀聯頁面完成支付信息錄入，最終完成支付。

步驟一：點擊銀聯在線支付圖標。圖-1
步驟二：跳轉銀聯頁面完成支付信息錄入。圖-2
步驟三：完成支付，提示成功。圖-3

圖-1

圖-2

圖-3

代付

代付是指商戶從自身單位結算賬戶向持卡人指定銀行卡賬戶進行款項劃付的業(yè)務。商戶進行代付交易時，必須在系統(tǒng)開設的賬戶內存在足夠的余額。

代扣

基于集團企業(yè)客戶對于資金單筆代扣、批量代扣的需求設計，代扣交易是指交易請求方（如商戶、用戶）將交易信息直接通過請求方服務器發(fā)送至服務器的交易方式。代扣交易均為同步短連接方式，不需要持卡人參與完成的交易類型。

版本說明

中茂恒潤移動支付平臺接口文檔

●    2016-08-06

     V1.0 初始版本

●    2017-03-01

     V1.1 統(tǒng)一支付接口新增：銀聯二維碼支付

●    2017-03-08

     V1.2 新增代扣接口新增微信/支付寶報件接口，微信訂單關閉接口

●    2017-03-20

     V1.3 新增京東支付/QQ錢包相關消費接口

●    2017-04-18

     V1.4 統(tǒng)一下單支付接口新增京東接口上送參數

中茂恒潤支付平臺接口文檔

●    2016-08-06

     V1.0 初始版本

●    2017-03-14

     V1.1 新增代扣接口

●    2017-07-31

     V1.2 頁面通知接口（B2C）

●    2017-09-04

     V1.3 代付接口升級

●    2017-09-20

     V1.4 新增快捷支付產品

名詞解釋

名詞	解釋
商戶	商戶是指在企業(yè)或個人在中茂支付平臺注冊成為商戶身份，可能通過中茂進行收款的角色。商戶必須是擁有營業(yè)執(zhí)照的企事業(yè)單位
商戶編號	商戶接入后，中茂按照相關標準分配給商戶的全局唯一的id
APPID	application identification微信公眾平臺服務號才有的，如果自己家的公眾平臺不是服務號，需要升級為服務號。就是相當于一個手機應用軟件，可以將一個公眾號做成快捷方式，放在手機應用里
openid	用戶在公眾號內的身份標識，不同公眾號擁有不同的openid。商戶后臺系統(tǒng)通過登錄授權、支付通知、查詢訂單等API可獲取到用戶的openid。主要用途是判斷同一個用戶，對用戶發(fā)送客服消息、模版消息等。企業(yè)號用戶需要使用企業(yè)號userid轉openid接口將企業(yè)成員的userid轉換成openidd

通訊方式

所有報文域以key/value的形式，通過HTTPS以POST請求方式發(fā)送到中茂支付平臺。
接口請求結果實時響應到商戶，支付結果通過商戶提供的后臺通知地址，通知到商戶。

通訊地址

環(huán)境	地址	備注
測試	https://test.zhongmaopay.com/payment-gate-web/gateway/api/backTransReq
生產	http://www.a2a6.cn/payment-gate-web/gateway/api/backTransReq
官網	http://www.a2a6.cn/
商戶后臺	http://www.a2a6.cn/merchantWeb/login

簽名機制

為保證數據傳輸過程中的數據真實性，完整性和不可抵賴，我們需要對數據進行數字簽名，在接收簽名數據之后進行簽名校驗。簽名算法為RSA。簽名是為了防止從商戶系統(tǒng)提交的支付請求以及通知數據被非法篡改。

報文簽名機制

根據接口報文內容，把除簽名字段（signature）以外的所有值為非空的字段按照報文字段的自然順序升序，依次按照“字段名=字段值”的方式用“&”符號連接符拼接成待簽名串。其次，對待簽名串使用SHA-1算法做摘要，再使用中茂頒發(fā)給商戶的商戶RSA私鑰證書對摘要做簽名操作（簽名時算法選擇SHA-1）。最后，對簽名做Base64編碼，將編碼后的簽名串放在簽名（signature），填入待提交的簽名字段。
簽名字符串樣式如下：

											acctNo=123456789&customerName=xiaowu&cvn2=111&expDate=1612&merNo=135708127590000&orderNo=20160306113223302&phoneNo=13312345678&transAmt=1

報文簽名驗簽機制

根據響應報文內容，把除簽名字段（signature）以外的所有值為非空的字段按照報文字段的自然順序升序，依次按照“字段名=字段值”的方式用“&”符號連接符拼接成待簽名串。其次，對待簽名串使用SHA-1算法做摘要，再使用中茂頒發(fā)給商戶的商戶RSA公鑰證書對摘要和報文中的簽名信息做簽名驗證操作。注意事項：驗簽切勿按接口字段獲取參數驗簽，需獲取所有響應字段參與驗簽，以防因接口新增參數而導致驗簽失敗。

注意事項

1、測試時注意測試環(huán)境、生產的地址，見【通訊方式】。
2、簽名注意事項：

1）、不能傳遞空參注意
2）、參數值不能包含空格
3）、參數順序必須和文檔一致
4）、確認證書是否是最新版本
5）、測試時要結合demo和文檔一起進行
6）、報文編碼只支持UTF-8。編碼時只針對待簽名字符串，signature不參與編碼

符號約定

符號	含義
M	必輸入或輸出的域
C	可輸入或輸出的域

數據元類型定義

Ax	x字節(jié)定長的字母字符
Ax..y	長度為x-y字節(jié)的變長字母字符
ANx	x字節(jié)定長的字母和/或數字字符
ANx..y	長度為x-y字節(jié)的變長字母和/或數字字符
ANSx	x字節(jié)定長的字母、數字和/或特殊符號字符
ANSx..y	長度為x-y字節(jié)的變長字母、數字和/或特殊符號字符
ASx	x字節(jié)定長的字母和/或特殊符號字符
ASx..y	長度為x-y字節(jié)的變長字母和/或特殊符號字符
Nx	x字節(jié)定長的整型數值，若表示金額，則以分為單位
Nx..y	長度為x-y字節(jié)的整型數值，若表示金額，則以分為單位
NSx	x字節(jié)定長的數字符和/或特殊字符
NSx..y	長度為x-y字節(jié)的數字字符和/或特殊字符
Sx	x字節(jié)定長的特殊符號字符
Sx..y	長度為x-y字節(jié)的變長特殊符號字符
ss	秒
DD	日
hh	時
MM	月
mm	分
YY	年（2字節(jié)）
YYYY	年（4字節(jié)）
VARx	個數為x的復合數據元集，數據元內使用\|分割，數據元之間使用逗號,分割
VARx..y	個數為x-y的復合數據元集，數據元內使用\|分割，數據元之間使用逗號,分割

統(tǒng)一下單

說明：此接口支持微信支付、支付寶、QQ錢包、京東等產品。請注意文檔中的產品類型（productId）、交易類型等參數（transId），參數值請留意注釋。

請求字段

字段	名稱	屬性	注釋	數據類型
requestNo	請求流水號	M	交易請求流水號	as..32
version	版本號	M	V1.0 V3.0異步通知返回卡類型	as..4
productId	產品類型	M	0104-微信掃碼支付 0105-微信公眾號支付 0106-微信刷卡（反掃） 0107-微信H5支付 0108-APP支付 0109-支付寶掃碼支付 0110-支付寶刷卡支付 0115-支付寶支付窗支付 0112-QQ掃碼支付 0113-QQ公眾號支付 0114-QQ付款碼支付 0116-網銀B2C 0117-京東掃碼 0118-京東付款碼支付 0119-京東商戶二維碼支付 0120-京東H5支付 0121-銀聯二維碼刷卡支付（反掃） 0122-銀聯二維碼掃碼支付（主掃）
transId	交易類型	M	10-微信/支付寶/QQ/京東消費 19-銀聯二維碼刷卡支付（反掃）消費 20-銀聯二維碼掃碼支付（主掃）消費
merNo	商戶號	M	商戶號	as..30
orderDate	訂單日期	M	商品訂單支付日期yyyyMMdd	N8
orderNo	商戶訂單號	M	商戶訂單號	as..32
notifyUrl	異步通知地址	M	異步通知地址	as..256
transAmt	交易金額	M	交易金額，單位為分	N12
commodityName	商品名稱	M	商品名稱	ans..64
openid	微信openId	C	當產品類型為0105時，必填	as..256
authCode	授權碼	C	所有反掃產品，必填	as..256
storeId	商戶門店編號	C	當產品類型為0109、0110時，必填格式：字母或數字組合，不能為中文，否則會存在風控限制例如：s1000017	as..32
terminalId	商戶機具終端編號	C	當產品類型為0109時、0110時，必填格式：字母或數字組合，不能為中文，否則會存在風控限制例如：t9000026	as..32
subMerNo	商戶識別id	M	所有微信支付，QQ錢包，京東錢包支付產品必傳，格式為商戶號+收款商戶唯一識別號的數字組合。例如：88844005812100200000001。	as..40
subMerName	收款商戶名稱	M	為實際店名，不得用個人名稱代替，否則會存在風控限制。例如：百果園水果店。[詳見]	as..40
subChnlMerNo	中茂子商戶ID	C	子商戶ID由商戶在中茂報備獲得，交易時傳送該值	as..20
limitPay	指定支付方式	C	微信產品（不包含刷卡支付）可輸入no_credit --指定不能使用信用卡支付	as..10
qrValidTime	二維碼有效期	C	僅產品類型為0122時，可選送。上送后，超過二維碼有效期時限，將交易失敗。單位：秒	N8
omRt	外部商戶注冊時間	C	產品類型為0117、0118、0119、0120必須上送時間戳（格式樣例：1479802946200，如有不明請自行百度），建議使用商戶注冊時間時間戳而非當前時間的時間戳，降低京東錢包風控	N13
omType	外部商戶行業(yè)	C	產品類型為0117、0118、0119、0120必須上送，上送數值參考附錄京東行業(yè)值
omAdd	外部商戶地址	C	產品類型為0117，0118，0119，0120必須上送，填寫商戶注冊地址
signature	驗簽字段	M	驗簽字段	Var

響應字段

字段	名稱	屬性	數據類型
requestNo	請求流水號	M	as..32
version	版本號	M	as..4
productId	產品類型	M
transId	交易類型	M
merNo	商戶號	M	as..30
orderDate	訂單日期	M	N8
orderNo	商戶訂單號	M	as..32
notifyUrl	異步通知地址	M	as..256
transAmt	交易金額	M	N12
commodityName	商品名稱	M	ans..64
openid	微信openId	C	as..256
authCode	授權碼	C	as..256
storeId	商戶門店編號	C	as..32
terminalId	商戶機具終端編號	C	as..32
subMerNo	商戶識別id	M	as..40
subMerName	收款商戶名稱	M	as..40
respCode	應答碼	M	N4
respDesc	應答碼描述	M	ans..128
codeUrl	二維碼鏈接	M	ans..64
imgUrl	二維碼圖片	M	ans..128
payInfo	公眾號支付信息	M	ans..1000
subChnlMerNo	中茂子商戶ID	C	as..20
limitPay	指定支付方式	C	as..10
qrValidTime	二維碼有效期	C	N8
signature	驗簽字段	M	Var

subMerNo（商戶識別id）、subMerName（收款商戶名稱）屬于風控字段，需要填寫真實收款商戶名稱。在實際場景當中，加入有20家商家接入了平臺，所有商家的交易平臺都上送同一個商戶識別id、商戶名稱，恰好該商家是一家便利店，該便利店一上午（假設為4個小時）的交易金額通常在1萬左右，此時所有商家的交易金額均算在這一家商家上，就會出現交易金額高達幾十萬、幾百萬，顯然是不符合實際場景的，此時會觸發(fā)微信風控，導致封停。

支付狀態(tài)查詢接口

請求字段

字段	名稱	屬性	注釋	數據類型
requestNo	請求流水號	M	交易請求流水號	as..32
version	版本號	M	V1.0	as..4
transId	交易類型	M	04
merNo	商戶號	M	商戶號	as..30
orderDate	訂單日期	M	商品訂單支付日期yyyyMMdd	N8
orderNo	商戶訂單號	M	商戶訂單號	as..32
signature	驗簽字段	M	驗簽字段	Var

響應字段

字段	名稱	屬性	注釋	數據類型
requestNo	請求流水號	M		as..32
version	版本號	M		as..4
transId	交易類型	M
merNo	商戶號	M		as..30
orderDate	訂單日期	M		N8
orderNo	商戶訂單號	M		as..32
origRespCode	原交易應答碼	M	交易成功：0000	N4
origRespDesc	原交易應答碼描述	M		ans..128
transAmt	交易金額	M	交易金額，單位為分	N12
refundAmt	已退金額	M	已退金額，單位為分	N12
respCode	應答碼	M	respCode不等于0000時當未知狀態(tài)處理，繼續(xù)調用查詢接口；respCode等于0000時以origRespCode返回碼為準	N4
respDesc	應答碼描述	M		ans..128
payId	中茂訂單號	C	交易請求版本號上送2.0時返回	as..30
payTime	支付完成時間	C	交易請求版本號上送2.0時返回, yyyyMMddHHmmss	as..20
customerName	持卡人姓名	C	當產品類型為0122時，返回姓名	as..30
acctNo	卡號	C	當產品類型為0121/0122時，返回銀行卡號	N32
signature	驗簽字段	M		Var

異步通知

請求字段

字段	名稱	屬性	注釋	數據類型
productId	產品類型	M	詳見各交易類接口
transId	交易類型	M	詳見各交易類接口
merNo	商戶號	M	商戶號	as..30
origOrderNo	商戶訂單號	M	原交易商戶訂單號	as..32
transAmt	交易金額	M	申請退貨金額，單位為分	N12
orderDate	訂單日期	M	商品訂單支付日期yyyyMMdd	N8
respCode	應答碼	M		N4
respDesc	應答碼描述	M		as..128
payId	中茂訂單號	C	交易請求版本號上送2.0時返回	as..30
payTime	支付完成時間	C	交易請求版本號上送2.0時返回, yyyyMMddHHmmss	as..20
bankType	卡類型	C	統(tǒng)一下單接口版本號V3.0時通知返回	as..20
customerName	持卡人姓名	C	當產品類型為0122時，返回姓名	as..30
acctNo	卡號	C	當產品類型為0121/0122時，返回銀行卡號	N32
signature	驗簽字段	M	驗簽字段	Var

響應字段

商戶接收通知成功返回“SUCCESS”字符串，不要包含如html等文本語言。

關閉訂單號

目前支持微信類產品的關閉訂單，支付寶等后續(xù)開放。對于原訂單結果未知或用戶支付超時時，可對原訂單發(fā)起關閉訂單，系統(tǒng)則退出不再受理該訂單，避免用戶繼續(xù)支付。

請求字段

字段	名稱	屬性	注釋	數據類型
requestNo	請求流水號	M	交易請求流水號	as..32
version	版本號	M	V1.0	as..4
transId	交易類型	M	21
merNo	商戶號	M	商戶號	as..30
orderDate	訂單日期	M	商品訂單支付日期yyyyMMdd	N8
orderNo	商戶訂單號	M	商戶訂單號	as..32
origOrderNo	原商戶訂單號	M	填寫需關閉的原訂單號	as..32
origOrderDate	原訂單日期	M	填寫需關閉的原訂單日期原商品訂單yyyyMMdd	N8
signature	驗簽字段	M	驗簽字段	Var

響應字段

字段	名稱	屬性	注釋	數據類型
requestNo	請求流水號	M		as..32
version	版本號	M	V1.0	as..4
transId	交易類型	M	21
merNo	商戶號	M		as..30
orderDate	訂單日期	M		N8
orderNo	商戶訂單號	M		as..32
origOrderNo	原商戶訂單號	M	關閉的原訂單號	as..32
origOrderDate	原訂單日期	M	關閉的原訂單日期原商品訂單yyyyMMdd	N8
respCode	應答碼	M	respCode不等于0000時表示關閉訂單失敗，參考respDesc的錯誤原因 0075：訂單已支付不允許關閉 0076：訂單已關閉 9999：系統(tǒng)異常	ans..64
respDesc	應答碼描述	M	交易處理中	ans..128
signature	驗簽字段	M		Var

微信/支付寶子商戶信息報件

此字段必須保證信息的準確性，聯系方式、電話等正確性，會在用戶端呈現及調用。

請求字段

字段	名稱	屬性	注釋	數據類型
requestNo	請求流水號	M	交易請求流水號	as..32
version	版本號	M	V1.0	as..4
transId	交易類型	M	23
merNo	商戶號	M	商戶號	as..30
applyType	報建類型	M	BANKSP	as..30
applyCont	報建內容	M	JSON格式
signature	驗簽字段	M	驗簽字段	Var

響應字段

字段	名稱	屬性	注釋	數據類型
requestNo	請求流水號	M		as..32
version	版本號	M		as..4
transId	交易類型	M
merNo	商戶號	M		as..30
applyType	報建類型	M	BANKSP	as..30
applyCont	報建內容	M	JSON格式
applyId	報建ID	C	報建信息唯一ID	As..12
respCode	應答碼	M	respCode等于P000表示報建內容已受理，待審核，可以不定時使用報建查詢接口查詢。	ans..64
respDesc	應答碼描述	M
signature	驗簽字段	M		Var

子商戶報建applyCont字段內容說明

字段	微信	支付寶
bankSpName	商戶名稱（必填），注意，商戶名稱必須是子商戶公眾號ID對應的主體，微信校驗	商戶名稱（必填）
aliasName	商戶簡稱（必填）	商戶簡稱（必填）
acceptFlag	是否使用民生受理公眾號（必填，取值'Y'或'N'）	是否使用民生PID（必填，取值'Y'或'N'），服務商模式下，必須使用服務商自己的PID
bankAcceptAppid	受理公眾號APPID（使用民生受理公眾號時候留空，不使用民生受理公眾號時必填。建議使用與民生簽約主體的公眾號。）（可修改）	受理商戶來源機構標識(pid)（使用民生PID時候留空，不使用民生PID時必填，要求服務商必須去注冊PID詳見，相關流程。）
bankAppId	子商戶公眾號ID（非必填，但公眾號支付、掃碼支付交易時，該值必填）（可修改）	無需填寫
authPaydir	支付授權目錄（非必填，但公眾號支付，該值必填）（可修改）	無需填寫
categoryId	微信經營目錄ID（必填，注意行業(yè)費率）	支付寶經營目錄ID（必填）
servicePhone	客服電話（必填，電話會在微信APP被持卡人調用）	客服電話（必填，純數字不帶符號）
contactName	聯系人（必填，建議填寫服務商自己的員工，微信會聯系差錯交易）	聯系人（必填）
contactPhone	聯系電話（純數字，不帶符號，必填，建議填寫服務商自己的員工，微信會聯系差錯交易）	聯系電話（必填，純數字不帶符號）
contactMobile	聯系手機（必填，純數字，不帶符號，建議填寫服務商自己的員工，微信會聯系差錯交易）	聯系手機（必填，純數字不帶符號）
contactEmail	聯系郵箱（必填，建議填寫服務商自己的員工，微信會聯系差錯交易）	聯系郵箱（必填）
chnlType	渠道類型（必填，取值'WEIXIN'，’WEIXINAPP’）	渠道類型（必填，取值'ALIPAY'）
state	民生狀態(tài)（信息查詢時候返回）	民生狀態(tài)（信息查詢時候返回）
chnlState	民生狀態(tài)（信息查詢時候返回）	民生狀態(tài)（信息查詢時候返回）

僅在民生狀態(tài)是"VALID"，并且渠道狀態(tài)是"ADD_SUCC"或"MOD_SUCC"的時候，該民生子商戶可正常交易。僅標識了“可修改”的字段，可以通過信息修改接口進行修改。若需要關注公眾號，請告知我行運營人員，在微信后臺進行配置。

信息查詢

注意區(qū)分查詢交易的狀態(tài)返回及信息報建狀態(tài)的區(qū)別，查詢成功不代表報建成功。

請求字段

字段	名稱	屬性	注釋	數據類型
requestNo	請求流水號	M	交易請求流水號	as..32
version	版本號	M	V1.0	as..4
transId	交易類型	M	18
merNo	商戶號	M	商戶號	as..30
applyType	報建類型	M	BANKSP	as..30
applyId	報建ID	M	BANKSP，同報建接口。	as..30
signature	驗簽字段	M	驗簽字段	Var

響應字段

字段	名稱	屬性	注釋	數據類型
requestNo	請求流水號	M		as..32
version	版本號	M		as..4
transId	交易類型	M	18
merNo	商戶號	M		as..30
applyType	報建類型	M	BANKSP	as..30
applyCont	報建內容	M	JSON格式
applyId	報建ID	C	報建信息唯一ID	As..12
respCode	應答碼	M	respCode等于0000表示查詢成功，否則查詢失敗。	ans..64
respDesc	應答碼描述	M
signature	驗簽字段	M		Var

信息修改

注意區(qū)分查詢交易的狀態(tài)返回及信息報建狀態(tài)的區(qū)別，查詢成功不代表報建成功。

請求字段

字段	名稱	屬性	注釋	數據類型
requestNo	請求流水號	M	交易請求流水號	as..32
version	版本號	M	V1.0	as..4
transId	交易類型	M	19
merNo	商戶號	M	商戶號	as..30
applyType	報建類型	M	BANKSP	as..30
applyId	報建ID	M	BANKSP，同報建接口。	as..30
signature	驗簽字段	M	驗簽字段	Var

響應字段

字段	名稱	屬性	注釋	數據類型
requestNo	請求流水號	M		as..32
version	版本號	M		as..4
transId	交易類型	M	19
merNo	商戶號	M		as..30
applyType	報建類型	M	BANKSP	as..30
applyCont	報建內容	M	JSON格式
applyId	報建ID	C	報建信息唯一ID	As..12
respCode	應答碼	M	respCode等于P000表示修改內容已受理，待審核，可不定時使用報建查詢接口查詢。	ans..64
respDesc	應答碼描述	M
signature	驗簽字段	M		Var

余額查詢

請求字段

字段	名稱	屬性	注釋	數據類型
requestNo	請求流水號	M	交易請求流水號	as..32
version	版本號	M	V1.0	as..4
transId	交易類型	M	09
merNo	商戶號	M	商戶號	as..30
signature	驗簽字段	M	驗簽字段	Var

響應字段

字段	名稱	屬性	注釋	數據類型
requestNo	請求流水號	M		as..32
version	版本號	M		as..4
transId	交易類型	M	09
merNo	商戶號	M		as..30
origRespCode	原交易應答碼	M	交易成功：0000	N4
origRespDesc	原交易應答碼描述	M		ans..128
avaBal	總余額	M	總余額（已入賬金額+未入賬金額）	N12
avaFreezeBal	總凍結金額	M	總凍結金額（已入賬凍結+未入賬凍結）	N12
cwcBal	已入賬金額	M	沉淀資金，由未入賬金額在次日清結算后轉入到已入賬金額中	N12
cwcFreezeBal	已入賬凍結金額	M	已入賬凍結金額	N12
signature	驗簽字段	M		Var

代扣

代扣交易是指交易請求方（如商戶、用戶）將交易信息直接通過請求方服務器發(fā)送至服務器的交易方式。代扣交易均為同步短連接方式，不需要持卡人參與完成的交易類型。若通訊超時，則交易請求方必須發(fā)起交易狀態(tài)查詢交易。

請求字段

字段	名稱	屬性	注釋	數據類型
requestNo	請求流水號	M	交易請求流水號	as..32
version	版本號	M	V1.0 V3.0（選擇V3.0時返回受理成功）	as..4
productId	產品類型	M	0111：廣東省內代收
transId	交易類型	M	01
merNo	商戶號	M	商戶號	as..30
orderDate	訂單日期	M	商品訂單支付日期yyyyMMdd	N8
orderNo	商戶訂單號	M	商戶訂單號	as..32
notifyUrl	異步通知地址	M	異步通知地址	as..256
transAmt	交易金額	M	交易金額，單位為分	N12
commodityName	商品名稱	M	商品名稱	ans..64
customerName	持卡人姓名	M	持卡人姓名	as..30
authCode	授權碼	C	所有反掃產品，必填	as..256
isCompay	對公對私標識	C	使用產品0111、0113時填寫，對公對私標識0為對私，1為對公	N1
settBankNo	清算行號	C	發(fā)卡號清算行號，使用產品0111、0113時填寫，商戶根據持卡人銀行卡情況自行獲取，詳見列表見附錄。注意：如填寫該字段，則accBankName、bankType、addrName字段均不需填寫	N12
accBankNo	持卡人開戶行號	C	使用產品0113省外代收時填寫	N12
accBankName	持卡人開戶行名稱	C	使用產品0111、0113，如accBankNo、settBankNo無法填寫時，則必須填寫該字段，可按照規(guī)范填寫：例子：佛山市禪城區(qū)農村信用合作聯社或佛山禪城農商行	ans..128
bankType	銀行類別	C	使用產品0111、0113，如accBankNo、settBankNo無法填寫時，則必須填寫該字段，標識一個銀行身份，如102：工商銀行 402：農信社。	N4
addrName	地區(qū)名稱	C	使用產品0111、0113，如accBankNo、settBankNo無法填寫時，則必須填寫該字段，填寫銀行卡所在城市，如廣州。如無法獲取城市，則填寫省份，	ans..20
busiType	業(yè)務類型	C	使用產品0111、0113時填寫，標識該筆消費用于什么業(yè)務，如保險、水電煤等，參考附錄列表	N6
signature	驗簽字段	M	驗簽字段	Var

響應字段

字段	名稱	屬性	數據類型
requestNo	請求流水號	M	as..32
version	版本號	M	as..4
productId	產品類型	M
transId	交易類型	M
merNo	商戶號	M	as..30
orderDate	訂單日期	M	N8
orderNo	商戶訂單號	M	as..32
notifyUrl	異步通知地址	M	as..256
transAmt	交易金額	M	N12
commodityName	商品名稱	M	ans..64
customerName	持卡人姓名	C	as..256
isCompay	對公對私標識	C	as..256
settBankNo	清算行號	C	as..32
accBankNo	持卡人開戶行號	C	as..32
accBankName	持卡人開戶行名稱	C	as..40
bankType	銀行類別	C	as..40
addrName	地區(qū)名稱	C	N4
busiType	業(yè)務類型	C	ans..128
respCode	應答碼	M	ans..64
respDesc	應答碼描述	M	ans..128
signature	驗簽字段	M	Var

無卡消費

消費是指境內持卡人在境內商戶網站進行購物等消費時用銀行卡結算的交易，經批準的消費額將即時地反映到該持卡人的賬戶余額上。此消費交易為由采集銀行卡相關信息，收單行頁面無須跳轉至銀聯或發(fā)卡行頁面完成交易。

請求字段

字段	名稱	屬性	注釋	數據類型
requestNo	請求流水號	M	交易請求流水號	as..32
version	版本號	M	V1.0	as..4
productId	產品類型	M	0103：無卡 0123：小額無卡 0130：快捷支付 0140：小額快捷支付
transId	交易類型	M	01
merNo	商戶號	M	商戶號	as..30
orderDate	訂單日期	M	商品訂單支付日期yyyyMMdd	N8
orderNo	商戶訂單號	M	商戶訂單號	as..32
notifyUrl	異步通知地址	M	異步通知地址	as..256
transAmt	交易金額	M	交易金額，單位為分	N12
commodityName	商品名稱	M	商品名稱	ans..64
phoneNo	預留手機號	M	銀行卡預留手機號	as..30
customerName	持卡人姓名	M	持卡人姓名	as..30
cerdType	證件類型	M	持卡人證件類型 01：身份證 02：軍官證 03：護照 04：回鄉(xiāng)證 05：臺胞證 06：警官證 07：士兵證 99：其它證件
cerdId	證件號	M	證件號	as..32
acctNo	卡號	M	銀行卡號	N32
cvn2	CVN2	M	信用卡時必填	N3
expDate	卡有效期	M	信用卡時必填(YYMM)	N4
quickToken	Token	M	虛擬Token，用戶信息和token值二選一	N20
signature	驗簽字段	M	驗簽字段	Var

響應字段

字段	名稱	屬性	注釋	數據類型
requestNo	請求流水號	M	交易請求流水號	as..32
version	版本號	M	V1.0	as..4
productId	產品類型	M	0103
transId	交易類型	M	01
merNo	商戶號	M	商戶號	as..30
orderDate	訂單日期	M	商品訂單支付日期yyyyMMdd	N8
orderNo	商戶訂單號	M	商戶訂單號	as..32
notifyUrl	異步通知地址	M	異步通知地址	as..256
transAmt	交易金額	M	交易金額，單位為分	N12
commodityName	商品名稱	M	商品名稱	ans..64
customerName	持卡人姓名	M	持卡人姓名	as..30
cerdType	證件類型	M	持卡人證件類型 01：身份證 02：軍官證 03：護照 04：回鄉(xiāng)證 05：臺胞證 06：警官證 07：士兵證 99：其它證件
cerdId	證件號	M	證件號	as..32
acctNo	卡號	M	銀行卡號	N32
cvn2	CVN2	M	信用卡時必填	N3
expDate	卡有效期	M	信用卡時必填(YYMM)	N4
quickToken	Token	M	虛擬Token，用戶信息和token值二選一	N20
respCode	應答碼	M		N4
respDesc	應答碼描述	M		ans..128
signature	驗簽字段	M	驗簽字段	Var

注：
一、關于產品類型
無卡消費目前有4種產品類型，交易時，除產品類型參數的值不同外，其它參數均相同。
二、關于0130快捷支付
1、第一次交易成功后，會返回quickToken，此后的交易只需傳送quickToken，6要素等參數不需要傳送。
2、當6要素等信息發(fā)生變化時，則需從新傳送6要素參數，無需傳送quickToken。當交易成功后，會返回quickToken，之前的quickToken將作廢。
3、交易成功后，已經返回了quickToken，如果不是卡6要素信息發(fā)生，需要重新生成quickToken，就不要再傳送6要素，否則會生成新的quickToken，之前的quickToken就會作廢。

退貨

消費交易完成后，可進行退貨交易，可退貨訂單日期根據銀行通道一般有3-6個月，具體根據商戶協議確定。

請求字段

字段	名稱	屬性	注釋	數據類型
requestNo	請求流水號	M	交易請求流水號	as..32
version	版本號	M	新接口V1.0	as..4
transId	交易類型	M	02
merNo	商戶號	M	商戶號	as..30
orderDate	退貨日期	M	退貨申請日期yyyyMMdd	N8
orderNo	退貨訂單號	M	退貨申請訂單號	as..32
origOrderDate	訂單日期	M	原交易商戶訂單號	N8
origOrderNo	商戶訂單號	M	原交易商戶訂單號	as..32
notifyUrl	異步通知地址	M	異步通知地址	as..256
transAmt	交易金額	M	申請退貨金額，單位為分	N12
refundReson	退貨原因	M	退貨原因	as..256
signature	驗簽字段	M	驗簽字段	Var

響應字段

字段	名稱	屬性	注釋	數據類型
requestNo	請求流水號	M	交易請求流水號	as..32
version	版本號	M	新接口：V1.0	as..4
transId	交易類型	M	02
merNo	商戶號	M		as..30
orderDate	退貨日期	M	退貨申請日期yyyyMMdd	N8
orderNo	退貨訂單號	M	退貨申請訂單號	as..32
origOrderDate	訂單日期	M	原交易商戶訂單號	N8
origOrderNo	商戶訂單號	M	原交易商戶訂單號	as..32
notifyUrl	異步通知地址	M		as..256
transAmt	交易金額	M		N12
refundReson	退貨原因	M	退貨原因	as..256
respCode	應答碼	M	P000表示下單成功，待用戶支付	ans..64
respDesc	應答碼描述	M	交易處理中	ans..128
orderTime	訂單交易時間	M	支付平臺側訂單交易時間YYYYMMDDhhmmss	N14
signature	驗簽字段	M		Var

撤銷

撤銷是指撤銷當天的交易，其他時間交易撤銷始終報失敗。

請求字段

字段	名稱	屬性	注釋	數據類型
requestNo	請求流水號	M	交易請求流水號	as..32
version	版本號	M	新接口V1.0	as..4
transId	交易類型	M	03
merNo	商戶號	M	商戶號	as..30
orderDate	撤銷日期	M	撤銷申請日期yyyyMMdd	N8
orderNo	撤銷訂單號	M	撤銷申請訂單號	N8
origOrderNo	商戶訂單號	M	原交易商戶訂單號	as..32
notifyUrl	異步通知地址	M	異步通知地址	as..256
transAmt	交易金額	M	申請退貨金額，單位為分	N12
signature	驗簽字段	M	驗簽字段	Var

響應字段

字段	名稱	屬性	注釋	數據類型
requestNo	請求流水號	M	交易請求流水號	as..32
version	版本號	M	新接口：V1.0	as..4
transId	交易類型	M	03
merNo	商戶號	M	商戶號	as..30
orderDate	撤銷日期	M	撤銷申請日期yyyyMMdd	N8
orderNo	撤銷訂單號	M	撤銷申請訂單號	N8
origOrderNo	商戶訂單號	M	原交易商戶訂單號	as..32
notifyUrl	異步通知地址	M	異步通知地址	as..256
transAmt	交易金額	M	申請退貨金額，單位為分	N12
respCode	應答碼	M		N4
respDesc	應答碼描述	M		ans..128
orderTime	訂單交易時間	M	支付平臺側訂單交易時間YYYYMMDDhhmmss	N14
signature	驗簽字段	M	驗簽字段	Var

代付

代付業(yè)務指商戶從自身單位結算賬戶向持卡人指定銀行卡賬戶進行款項劃付的業(yè)務。

請求字段

字段	名稱	屬性	注釋	數據類型
requestNo	請求流水號	M	交易請求流水號	as..32
version	版本號	M	V1.0：初始版本 V2.0：異步通知返回merNo信息 V3.0：代付關聯消費訂單	as..4
productId	產品類型	M	0201-普通代付,0203-額度代付
transId	交易類型	M	07	N2
merNo	商戶號	M	商戶號	as..30
orderDate	訂單日期	M	商品訂單支付日期yyyyMMdd	N8
orderNo	商戶訂單號	M	商戶訂單號	as..32
notifyUrl	異步通知地址	M	異步通知地址	as..256
transAmt	代付金額	M	交易金額，單位為分，V3.0時代付金額必須小于等于原訂單金額	N12
isCompay	對公對私標識	C	對公對私標識0為對私，1為對公	N1
phoneNo	代付銀行手機號	M	代付銀行手機號	as..30
customerName	代付賬戶名稱	M	代付賬戶名稱	as..30
cerdType	代付證件類型	C	代付證件類型 01：身份證 02：軍官證 03：護照 04：回鄉(xiāng)證 05：臺胞證 06：警官證 07：士兵證 99：其它證件	N2
cerdId	代付證件號	C	代付證件號	as..32
accBankNo	代付開戶行號	C	收款賬戶開戶行號	as..32
accBankName	代付開戶行名稱	C	收款賬戶開戶行名稱	ans..64
acctNo	代付賬號	M	銀行卡號	N32
note	代付摘要	C	代付摘要	as..255
origOrderDate	訂單日期	M	原商品訂單的日期yyyyMMdd，V3.0時必填	N8
origOrderNo	商戶訂單號	M	原交易商戶訂單號，V3.0時必填	as..32
signature	驗簽字段	M	驗簽字段	Var

響應字段

字段	名稱	屬性	注釋	數據類型
requestNo	請求流水號	M		as..32
version	版本號	M	V1.0	as..4
merNo	商戶號	M		as..30
orderDate	訂單日期	M		N8
orderNo	商戶訂單號	M		as..32
transAmt	代付金額	M	代付金額，單位為分	N12
respDesc	應答碼描述	M		N4
respDesc	應答碼描述	M		ans..128
orderTime	訂單交易時間	M	支付平臺側訂單交易時間YYYYMMDDhhmmss	N14
signature	驗簽字段	M		Var

注：
代付version傳V3.0時，即關聯消費訂單，此時需要傳送消費的訂單號和訂單日期，同時需要注意代付的金額要低于消費時的金額。

短信通知

請求字段

字段	名稱	屬性	注釋	數據類型
requestNo	請求流水號	M	交易請求流水號	as..32
version	版本號	M	V1.0	as..4
productId	產品類型	M	0401
transId	交易類型	M	17
merNo	商戶號	M	商戶號	as..30
phoneNo	手機號	M		N11
memo	短信內容	M		ans..120
signature	驗簽字段	M	驗簽字段	Var

響應字段

字段	名稱	屬性	注釋	數據類型
respCode	應答碼	M	0000交易成功 0073 短信發(fā)送失敗 9999 系統(tǒng)異常	ans..64
respDesc	應答碼描述	M	0000交易成功 0073 短信發(fā)送失敗 9999 系統(tǒng)異常	ans..128

網銀B2C

字段	名稱	屬性	注釋	數據類型
requestNo	請求流水號	M	交易請求流水號	as..32
version	版本號	M	V1.0(直接跳網銀頁面) V2.0(返回網銀頁面HTML內容)	as..4
productId	產品類型	M	0116
transId	交易類型	M	23
merNo	商戶號	M	商戶號	as..30
orderDate	訂單日期	M	商品訂單支付日期yyyyMMdd	N8
orderNo	商戶訂單號	M	商戶訂單號	as..32
notifyUrl	異步通知地址	M	異步通知地址	as..256
transAmt	交易金額	M	交易金額，單位為分	N12
commodityName	商品名稱	M	商品名稱	ans..64
commodityDesc	商品描述	M		ans..64
bankPayType	網銀類型	M	01:B2C網銀 02:B2B網銀	N2
cardType	銀行卡類型	M	01：借記卡 02：貸記卡	N2
bankCode	銀行縮寫	M	詳見附錄	as..64
signature	驗簽字段	M	驗簽字段	Var

響應字段

字段	名稱	屬性	注釋	數據類型
requestNo	請求流水號	M		as..32
version	版本號	M		as..4
productId	產品類型	M
transId	交易類型	M
merNo	商戶號	M		as..30
orderDate	訂單日期	M		N8
orderNo	商戶訂單號	M		as..32
notifyUrl	異步通知地址	M		as..256
transAmt	交易金額	M		N12
commodityName	商品名稱	C		ans..64
respCode	應答碼	M	P000表示下單成功，待用戶支付	ans..64
respDesc	應答碼描述	M	交易處理中	ans..128
commodityDesc	商品描述	M		Ans..64
bankPayType	網銀類型	M		N2
cardType	銀行卡類型	M		N2
bankCode	銀行縮寫	M		as..64
htmlInfo	頁面內容	M	對內容進行Base64解碼	Var
signature	驗簽字段	M		Var

對賬文件

說明：測試環(huán)境沒有對賬文件，無法進行測試。開發(fā)人員請前往下載中心下載對賬文件模板，itf文件為響應數據，txt文件為對賬文件。

請求字段

字段	名稱	屬性	注釋	數據類型
requestNo	請求流水號	M	交易請求流水號	as..32
version	版本號	M	新接口V1.1	as..4
transId	交易類型	M	14
merNo	商戶號	M	商戶號	as..30
postingDate	清算日期	M	yyyyMMdd T日交易一般去T+1日對賬文件	N8
signature	驗簽字段	M		Var

響應字段

字段	名稱	屬性	注釋	數據類型
respCode	應答碼	M	0000表示成功	ans..64
respDesc	應答碼描述	M		ans..128
filecontent	文件流	M	對字段進行Base64解碼

對賬文件格式說明

1、第一行為合計信息，之后每行記錄為一條交易明細。
2、文件內容每行必須符合標準格式，且每行必須以回車換行結束。
3、數據項之間以“|”逗號分隔。
4、如數據項為空時，則相應的數據項不需填任何信息（包括空格）
5、每一行記錄標準格式：（首行合計）記賬日期,成功總筆數,成功總金額,總手續(xù)費,清算金額（明細）記賬日期,父級商戶號,商戶號,支付產品,交易類型,商品訂單號,交易時間,交易金額,交易手續(xù)費,清算金額,原商品訂單號,原交易時間,備注
6、文件首記錄：

序號	長度	類型	描述
1	8	字符型	記賬日期yyyyMMdd
2	12	數值型	成功總筆數
3	15	數值型	成功總金額（單位：分）
4	12	數值型	成功總手續(xù)費（單位：分）
5	15	數值型	清算金額（單位：分）

對賬明細數據域描述：

序號	長度	類型	描述
1	8	字符型	記賬日期yyyyMMdd
2	15	字符型	父級商戶號
3	15	字符型	商戶號
4	4	字符型	支付產品
5	20	字符型	交易類型
6	32	字符型	商品訂單號
7	20	字符型	交易時間yyyy-MM-dd hh:mm:ss
8	14	數值型	交易金額（單位分）
9	9	數值型	交易手續(xù)費（單位分）
10	14	數值型	清算金額（單位分）
11	20	字符型	原商品訂單號(可為空，在退款交易出現)
12	20	字符型	原交易時間(可為空，在退款交易出現)
13	64	字符型	備注(擴展) 附加信息，自定義保留域

交易返回碼列表

請仔細閱讀返回碼列表，進行相應的處理機制。

一、交易接口

1、交易成功：返回0000，表示交易成功
2、中間狀態(tài)：下列情況為中間狀態(tài)，即訂單狀態(tài)為支付中，處理方式參考中間狀態(tài)處理方案。

P000：交易處理中；

9999：系統(tǒng)異常;

9997：交易結果未知;

0028：原交易不存在;

未接收到響應；

http響應碼為非200(網絡原因、系統(tǒng)不穩(wěn)定、系統(tǒng)重啟等)。

3、交易失?。浩渌e誤碼，根據交易返回碼進行處理
注：P000表示下單成功，例如微信、支付寶、QQ錢包等，此時等待用戶支付。0000表示支付成功。

二、查詢接口

1、成功狀態(tài)：respCode返回0000，并且origRespCode返回0000
2、中間狀態(tài)：

a） respCode返回非0000，默認當中間狀態(tài)處理；

b） respCode 返回0000-查詢交易成功的情況；

（1）origRespCode 返回P000(交易處理中)/9999(系統(tǒng)異常)/9997（交易結果未知）

（2）origRespCode返回0028，訂單因為參數原因被拒或網絡原因沒有入庫，查詢時間和交易間隔時間較短都可能返回該錯誤碼。

c）未接受到響應

d） http響應碼為非200(網絡原因、系統(tǒng)不穩(wěn)定、系統(tǒng)重啟等)時；

3、失敗狀態(tài)：respCode返回0000，origRespCode返回非如上錯誤碼，原交易訂單為失敗
注：respCode返回0000表示查詢成功，但是原訂單的交易狀態(tài)結果還需要根據origRespCode來確定處理方式

三．中間狀態(tài)處理方案

1、中間狀態(tài)一般需要等待我行的異步通知,建議做好用戶提示：

正向交易：包括微信/支付寶/QQ錢包/京東錢包/無卡快捷/代扣等消費支付交易，建議顯示支付進度條或者提示支付中，默認先將狀態(tài)當支付失敗狀態(tài)處理先，等待異步通知或者向我行核實交易狀態(tài)處理。

負向交易：包括代付/退貨/撤銷等接口默認將中間狀態(tài)當成功處理避免款項處理錯誤，但是在用戶端顯示：“代付/退款中，請在XXX小時后…..，聯系客戶xxxxx”避免用戶緊張或者投訴。

2、對于實體商戶，微信和支付寶的支付交易請求如果為中間狀態(tài)（尤其出現客戶支付成功，系統(tǒng)仍然顯示支付中情況下），超過30s-40s仍然為中間狀態(tài)，可以調用訂單關閉接口，關閉訂單處理。
3、調用查詢接口，需控制查詢間隔時間和查詢次數，以免對上游系統(tǒng)和自家系統(tǒng)造成系統(tǒng)壓力，尤其微信、支付寶類需二次交互的交易需嚴格控制。建議間隔時間30s /60s/180s/600s的間隔時間查詢，如果600s后仍然為中間狀態(tài)，建議人工核實。

返回碼	中文描述	返回碼	中文描述
中間狀態(tài)（需要再發(fā)起查詢，直至返回明確成功或失敗）
P000	交易處理中	9999	系統(tǒng)異常（出現9999錯誤碼時，建議與上游確認再處理）
9997	交易結果未知	0028	原交易不存在（出現0028錯誤碼時，建議與上游確認再處理）
明確成功
0000	交易成功
明確失敗
0001	請求參數非法	0002	商戶號不能為空
0003	商戶訂單號不能為空	0004	銀行預留手機號不能為空
0005	交易金額不能為空	0006	卡號不能為空
0007	CVN2不能為空	0008	信用卡有效期不能為空
0009	驗簽字段不能為空	0010	商戶信息不存在
0011	商戶狀態(tài)異常	0012	校驗簽名失敗
0013	商戶密鑰信息不存在	0014	商戶密鑰已失效
0015	獲取商戶密鑰ID失敗	0016	產品信息不存在
0017	產品信息狀態(tài)異常	0018	未授權的交易
0019	渠道約束信息為空	0020	不支持的卡類型
0021	不支持借記卡交易	0022	不支持貸記卡交易
0023	訂單號重復	0024	訂單信息保存失敗
0025	驗證銀行結果簽名失敗	0026	支付信息保存失敗
0027	未知交易類型	0028	原交易不存在
0029	原交易狀態(tài)異常	0030	交易金額超限
0031	路由篩選失敗	0032	交易金額非法
0033	銀行卡信息保存失敗	0034	當天交易不支持退款
0035	原交易已撤銷	0036	非當天交易不支持撤銷
0037	原交易已發(fā)起撤銷或退貨	0038	不支持的銀行卡
0039	原交易不支持撤銷	0040	上一筆撤銷交易正在處理中
0041	上一筆退貨交易正在處理中	0042	余額不足
0043	生成代付單失敗	0044	商品訂單狀態(tài)異常
0045	支付訂單狀態(tài)異常	0046	交易限額超限
0047	交易金額與原交易不符	0048	聯行號不存在
0049	該時間段不允許交易	0050	訂單日期無效
0051	短信驗證碼請求過于頻繁,請稍后再試	0052	手機號非法
0053	短信驗證碼錯誤次數過多,請稍候再試	0054	未獲取短信驗證碼或短信驗證碼為空
0055	短信驗證碼不能為空	0056	短信驗證碼錯誤
0057	文件獲取日期格式錯誤	0058	查詢日期范圍不能超過31天
0059	獲取卡號信息異常	0060	當前交易無需發(fā)送短信
0061	交易不支持退款	0062	獲取微信授權信息失敗
0063	獲取微信配置信息失敗	0064	對賬ftp創(chuàng)建文件失敗
0065	對賬文件不存在	0066	余額凍結失敗
0067	訂單凍結失敗	0068	更新代付訂單失敗
0069	更新商品訂單失敗	0070	更新支付訂單失敗
0071	獲取動態(tài)密鑰失敗	0072	短信發(fā)送成功
0073	短信發(fā)送失敗	0074	短信發(fā)送條數超限
0075	手機號碼格式不正確	0076	短信模板不存在
0077	短信內容未報備	0078	訂單已支付不允許關閉
0079	訂單已關閉	0080	無法匹配聯行號
9996	交易已退貨	9998	交易失敗
交易金額或交易次數超限
1000	交易金額或交易次數超限	1001	交易金額超限
1002	交易次數超限

銀行編碼

簡稱	名稱	簡稱	名稱
ICBC	工商銀行	ABC	農業(yè)銀行
BOC	中國銀行	CCB	建設銀行
CMB	招商銀行	BOCM	交通銀行
CMBC	民生銀行	CNCB	中信銀行
BOB	北京銀行	GDB	廣發(fā)銀行
PSBC	郵儲銀行	SPDB	浦發(fā)銀行
CEB	中國光大銀行	CIB	興業(yè)銀行
HXB	華夏銀行	PAB	平安銀行
BOS	上海銀行	BOHC	渤海銀行
BOJ	江蘇銀行	BJRCB	北京農商銀行
NJCB	南京銀行	NBBANK	寧波銀行
HZCB	杭州銀行

業(yè)務類型

定義范圍	類別	名稱	序號	編碼
0	01	電費	00	00100
		家用電費	01	00101
		生產用電費	02	00102
		……	……	……
0	02	水暖費	00	00200
		用水費	01	00201
		排水費	02	00202
		直飲水費	03	00203
		污水處理費	04	00204
		暖氣費	05	00205
		……	……	……
0	03	煤氣費	00	00300
		管道煤氣費	01	00301
		……	……	……
0	04	電話費	00	00400
		市內電話費	01	00401
		長途電話費	02	00402
		移動電話費	03	00403
		電話初裝費	04	00404
		IP電話費	05	00405
		……	……	……
0	05	通訊費	01	00500
		數據通訊費	02	00501
		線路月租費	03	00502
		代維費	04	00503
		網絡使用費	05	00504
		信息服務費	06	00505
		移動電子商務費	07	00506
		網關業(yè)務費	08	00507
		手機話費	09	00508
		……	……	……
0	06	保險費	00	00600
		續(xù)期壽險費	01	00601
		社會保險費	02	00602
		養(yǎng)老保險費	03	00603
		醫(yī)療保險費	04	00604
		車輛保險費	05	00605
		……	……	……
0	07	房屋管理費	00	00700
		房屋租賃費	01	00701
		租賃服務費	02	00702
		物業(yè)管理費	03	00703
		清潔費	04	00704
		保安服務費	05	00705
		電梯維護保養(yǎng)費	06	00706
		綠化費	07	00707
		停車費	08	00708
		……	……	……
0	08	代理服務費	00	00800
		押運服務費	01	00801
		票據傳遞費	02	00802
		代理記賬服務費	03	00803
		……	……	……
0	09	學教費	00	00900
		報考費	01	00901
		學雜費	02	00902
		保教費	03	00903
		……	……	……
0	10	有線電視費	00	01000
		有線電視租賃費	01	01001
		移動電視費	02	01002
		……	……	……
0	11	機構管理費用	00	01100
		工商行政管理費	01	01101
		商檢費	02	01102
		……	……	……
0	49	其他費用	00	04900
		土地使用費	01	04901
		加油卡費	02	04902
		消費貸款	03	04903
		……	……	……
0	51	薪金報酬	00	05100
		工資	01	05101
		獎金	02	05102
		養(yǎng)老金	03	05103
		……	……	……
0	99	其他代付費用	00	09900
		付福利彩票獎金	01	09901
		……	……	……

銀行編碼

二級/三級商戶行業(yè)	碼值	二級/三級商戶行業(yè)	碼值
本地生活服務	1	教育培訓	5
KTV	1001	教育培訓	5001
電影/KTV	1002	其他票務	6
結婚婚慶	1003	4D/5D電影	6001
咖啡茶館	1004	抵用券	6002
麗人	1005	電影	6003
美發(fā)洗浴	1006	門票	6004
其他娛樂	1007	演出賽事	6005
攝影	1008	汽車及配件	7
生活服務	1009	汽車服務	7001
休閑娛樂	1010	汽車用品	7002
養(yǎng)生休閑	1011	日用百貨	8
運動健身	1012	包	8001
桌游電玩	1013	彩妝	8002
寵物用品	2	成人用品	8003
寵物護理	2001	服飾內衣	8004
寵物用品	2002	服裝	8005
公益	3	服裝鞋包	8006
抽獎公益	3001	個護化妝	8007
機票/旅游	4	戶外用品	8008
出境游	4001	護膚保養(yǎng)	8009
國內游	4002	化妝工具	8010
豪華型酒店	4003	家紡	8011
經濟型酒店	4004	家居家紡	8012
酒店	4005	家居家具	8013
酒店旅游	4006	家清紙品	8014
旅游	4007	健康護理	8015
特色酒店	4008	流行飾品	8016
團房	4009	母嬰玩具	8017
小時房	4010	男士用品	8018
周邊游	4011	男裝	8019
食品	9	女性護理	8020
餐飲美食	9001	女裝	8021
沖調	9002	時尚禮品	8022
蛋糕甜品	9003	童裝	8023
地方菜	9004	玩具	8024
地方特產	9005	洗滌護理	8025
干貨速食	9006	香水	8026
海鮮	9007	鞋	8027
火鍋	9008	鞋包配飾	8028
進口食品	9009	嬰兒服飾	8029
酒飲	9010	嬰兒用品	8030
糧油調味	9011	孕媽用品	8031
茗茶	9012	珠寶眼鏡	8032
其他美食	9013	收藏品	10
日韓亞料理	9014	配飾、奢侈品	10001
燒烤	9015	奢侈品	10002
食品茶酒	9016	其它
西餐	9017	繳費充值	13
小吃快餐	9018	今日新單	14
休閑零食	9019	母嬰親子	15
嬰兒食品	9020	其他生活	16
營養(yǎng)保健	9021	全部商品	17
自助餐	9022	全部生活	18
圖書音像	12	運動戶外	19
圖書文具	12001	運動休閑	20
數碼電子	11	展覽	21
辦公設備	11001
大家電	11002
數碼產品	11003
數碼家電	11004
小家電	11005

閱讀對象

商務接入流程

微信和支付寶子商戶進件

微信掃碼支付

微信刷卡（反掃）

支付寶掃碼支付

支付寶刷卡支付

京東掃碼支付

京東付款碼支付

QQ錢包掃碼支付

QQ錢包付款碼支付

網銀B2

代付

代扣

版本說明

名詞解釋

通訊方式

通訊地址

簽名機制

報文簽名機制

報文簽名驗簽機制

注意事項

符號約定

數據元類型定義

統(tǒng)一下單

支付狀態(tài)查詢接口

異步通知

關閉訂單號

微信/支付寶子商戶信息報件

信息查詢

信息修改

余額查詢

代扣

無卡消費

退貨

撤銷

代付

短信通知

網銀B2C

對賬文件

對賬文件格式說明

交易返回碼列表

一、交易接口

二、 查詢接口

三．中間狀態(tài)處理方案

銀行編碼

業(yè)務類型

銀行編碼

二級/三級商戶行業(yè)

碼值

二級/三級商戶行業(yè)

碼值

二、查詢接口