【正文】 20141119實施20141104發(fā)布Q/CUP —2014Q/CUP中國銀聯(lián)股份有限公司規(guī)范性文檔中國銀聯(lián)股份有限公司 發(fā)布中國銀聯(lián)全渠道系統(tǒng)商戶接入測試指引代付產品e62 / 62版本修訂信息版本號完成日期發(fā)布日期變更說明20147032014703初稿2014110420141105修改文檔格式，新增測試地址與測試卡號等信息目錄1 文檔說明 6 導讀 6 閱讀對象 7 業(yè)務術語 7 技術服務 8 測試模式劃分 8 支持獲取途徑 92 聯(lián)調步驟向導 9 交易開發(fā) 9 測試聯(lián)調 9 切換上線 103 測試參數(shù)與產品相關交易 10 測試與生產地址 10 測試卡號 10 產品相關交易 11 產品介紹 124 交易模式說明 12 通訊方式 12 后臺資金類交易流程 12 后臺非資金類交易流程 14 查詢交易流程 14 批量交易流程 155 開發(fā)步驟向導 16 后臺類異步交易接口開發(fā)步驟 16 后臺類同步交易接口開發(fā)步驟 17 單筆查詢交易接口開發(fā)步驟 17 批量交易開發(fā)步驟 18 文件傳輸類交易開發(fā)步驟 196 前臺應答與后臺通知說明 197 查詢接口說明 21 前臺交易 21 后臺資金交易 21 后臺非資金交易 21 查詢交易 218 簽名機制 229 加密機制 2210 證書相關說明 23 概述 23 證書下載及導出流程(ok) 23 證書下載流程 23 2711 開發(fā)包插件使用 32 JSP/JAVA 32 配置文件說明 32 主要類和方法說明 35 配置文件加載說明 38 PHP 38 配置文件說明 38 主要類與方法說明 43 48 配置文件說明 49 主要類和方法說明 5212 常見問題問答 571 文檔說明 導讀代付是指商戶從自身單位結算賬戶向持卡人指定銀行卡賬戶進行款項劃付的業(yè)務，如保險理賠、基金分紅、代付貨款等。商戶通過銀聯(lián)在線支付平臺開展代付業(yè)務應與其收單機構簽訂相關代付協(xié)議，并向收單機構提供一定的備付金，然后通過銀聯(lián)在線支付商戶服務網站或后臺“批量類交易”報文發(fā)起付款。應用場景一（直聯(lián)商戶）：商戶按照“批量代付文件格式定義”生成代付文件，由其操作員登陸銀聯(lián)在線支付商戶服務網站上傳代付文件，并由另外的商戶操作員完成復核；或由其系統(tǒng)發(fā)起“批量類交易”報文上傳批付文件。收單機構操作員登陸銀聯(lián)在線支付收單機構服務網站，對所屬商戶的代付交易進行審核，審核通過后，銀聯(lián)在線支付平臺進行付款處理。商戶操作員可通過商戶服務網站，或由其系統(tǒng)發(fā)起“批量交易狀態(tài)查詢類交易”查詢下載代付結果文件。應用場景二（間聯(lián)商戶/機構）：商戶按照“批量代付文件格式定義”生成代付文件，提交至收單機構平臺。收單機構在自身平臺中完成交易審核，審核通過后，收單機構系統(tǒng)通過“批量類交易”報文上傳代付文件至銀聯(lián)在線支付平臺進行付款處理；收單機構系統(tǒng)發(fā)起“批量交易狀態(tài)查詢類交易”查詢下載代付結果文件。商戶從收單機構進行結果查詢和文件下載。首次接入測試先了解前臺交易與后臺交易的區(qū)別，隨后可從第5章節(jié)開發(fā)步驟向導開始閱讀，了解開發(fā)過程中的具體操作步驟，此章節(jié)中提到的簽名機制請參照第8章節(jié)。開發(fā)過程中需要用到的測試與生產交易地址請參考第11章節(jié)配置文件。如開發(fā)與測試過程中遇到了解決不了的問題可在第12章節(jié)FAQ中查找解決方案。 閱讀對象《中國銀聯(lián)全渠道系統(tǒng)商戶接入測試指引》文檔是面向具有一定的網站開發(fā)能力的網站開發(fā)、維護和管理人員。具體交易的接口、報文規(guī)范、響應碼說明，請閱讀開發(fā)包中接口文檔。參與方描述商戶指加入銀聯(lián)網絡，與銀聯(lián)簽訂《銀聯(lián)卡無卡支付業(yè)務合作協(xié)議》等協(xié)議開展銀聯(lián)無卡支付以及行業(yè)類應用業(yè)務的商戶。收單機構指加入銀聯(lián)網絡，與銀聯(lián)簽訂《銀聯(lián)卡無卡支付業(yè)務合作協(xié)議》開展銀聯(lián)無卡支付收單業(yè)務的境內成員機構。 業(yè)務術語術語解釋請求通過 HTTP/HTTPS協(xié)議把需要傳輸?shù)臄?shù)據發(fā)送給接收方的過程。應答通過 HTTP/HTTPS協(xié)議把需要傳輸?shù)臄?shù)據返回給接收方的過程。后臺通知服務器后臺通知。中國銀聯(lián)全渠道系統(tǒng)根據得到的數(shù)據處理完成后，全渠道系統(tǒng)主動發(fā)起通知給商戶的網站，同時攜帶處理完成的結果信息反饋給商戶網站。前臺類交易主要指用戶需要參與交互的支付類交易，包括消費、預授權/擔保消費交易。后臺類交易主要指用戶不需要參與交互，由商戶后續(xù)發(fā)起的交易，包括消費撤銷、退貨、預授權撤銷、預授權完成、預授權完成撤銷等交易。全渠道系統(tǒng)/ACP中國銀聯(lián)全渠道系統(tǒng)，是整合了銀聯(lián)在線和銀聯(lián)移動支付功能的新交易處理系統(tǒng)。 技術服務 測試模式劃分接入代付產品的商戶為選測。注：必測是指提交了入網申請表、必須測試通過才能投產上線的，選測是指不需要入網申請表可以直接投產上線的，是否在測試環(huán)境測試由商戶自己決定。必測選測收單機構接入商戶接入（接入產品為除無跳轉支付、后臺直接支付、代收和便民繳費以外的其他產品）商戶接入（接入產品為無跳轉支付、后臺直接支付、代收和便民繳費） 支持獲取途徑業(yè)務問題詳見開發(fā)包中《中國銀聯(lián)全渠道業(yè)務運營服務指引》相關人員聯(lián)系方式。測試問題支持人員聯(lián)系方式詳見下表：必測選測收單機構可聯(lián)系銀聯(lián)服務專員，并且在提交了入網申請后銀聯(lián)服務專員會主動聯(lián)系商定窗口并提供測試支持服務商戶可發(fā)送郵件到acpservice@（郵件標題為：商戶號+商戶名稱+聯(lián)系），提供商戶號和聯(lián)系，銀聯(lián)測試服務專員會將商戶接口人的聯(lián)系加入到銀聯(lián)統(tǒng)一服務中提供支持服務（商戶也可以通過服務電話021389299992049來提供自己的商戶號和聯(lián)系）銀聯(lián)市場服務代表在為商戶提交了入網申請后，會有銀聯(lián)服務專員主動聯(lián)系（一般為）商定聯(lián)調窗口并提供測試支持服務注：服務郵箱和服務電話僅供選測類商戶聯(lián)系測試支持人員，并且郵箱和電話不直接反饋支持問題，支持服務均在銀聯(lián)統(tǒng)一服務中提供。2 聯(lián)調步驟向導 交易開發(fā)商戶或收單機構參考全渠道系統(tǒng)開發(fā)包與本測試指引進行接入開發(fā)。 測試聯(lián)調本步驟可選。開發(fā)完成后可通過銀聯(lián)提供的聯(lián)調測試環(huán)境進行聯(lián)機接口驗證測試， 配置文件說明。 切換上線在測試環(huán)境完成聯(lián)調測試后，由銀聯(lián)業(yè)務運營人員(聯(lián)系方式參見《中國銀聯(lián)全渠道業(yè)務運營服務指引》)引導協(xié)助商戶完成生產交易證書的申請，商戶將接口更新部署到生產環(huán)境和銀聯(lián)生產環(huán)境完成對接。3 測試參數(shù)與產品相關交易 測試與生產地址測試地址詳見第11章節(jié)配置文件描述。 測試卡號測試卡號平安銀行借記卡：6216261000000000018證件號：341126197709218366手機號：13552535506密碼：123456姓名：全渠道平安銀行貸記卡：6221558812340000姓名：互聯(lián)網證件號：341126197709218366手機號：13552535506cvn2:123有效期：1711 產品相關交易序號接口名稱功能說明交易模式1代付類交易商戶從自身單位結算賬戶向持卡人指定銀行卡賬戶進行款項劃付的業(yè)務后臺資金類交易2交易狀態(tài)查詢類交易對未收到應答的或交易狀態(tài)未知的交易，可通過該交易進行查詢。查詢類交易3文件傳輸類交易聯(lián)機下載對賬文件等文件下載類交易后臺非資金交易4批量類交易用于商戶上傳批量代收文件到銀聯(lián)全渠道系統(tǒng)支付，發(fā)起批量代收交易批量類交易5批量交易狀態(tài)查詢類交易用于商戶到銀聯(lián)全渠道系統(tǒng)支付查詢批量代收交易狀態(tài)，并下載批量代收結果文件批量類交易6余額查詢后臺非資金類交易7電子現(xiàn)金非指定賬戶圈存后臺資金類交易8電子現(xiàn)金指定賬戶圈存后臺資金類交易9圈存腳本通知后臺資金類交易10IC卡脫機消費通知后臺資金類交易 產品介紹產品介紹詳見《代付產品入網材料》包中的《》。4 交易模式說明從技術實現(xiàn)方式上交易大致可劃分為前臺類交易、后臺資金類類交易、后臺非資金類交易、查詢類交易、批量類交易。本節(jié)將描述各種交易的大致流程。 通訊方式所有報文域以key/value的表單方式通過HTTP Post到銀聯(lián)全渠道系統(tǒng)支付平臺。對于前臺類需要持卡人交互的交易，交易通過異步跳轉的方式完成，對于涉及資金的前臺類交易，銀聯(lián)全渠道系統(tǒng)支付平臺可通過商戶后臺通知地址向商戶發(fā)送后臺通知。對于后臺類涉及資金清算類無需持卡人交互的交易，交易結果異步響應給商戶，商戶通過接受后臺通知或者發(fā)起交易查詢獲取交易處理結果。對于后臺類非資金類無需持卡人交互的交易，交易結果同步響應給商戶。對應交易狀態(tài)查詢類交易，交易結果同步響應給商戶。 后臺資金類交易流程后臺類資金類交易是指交易請求方（如商戶、收單機構），將交易信息（涉及資金清算的交易）直接通過請求方服務器發(fā)送至ACP服務器的交易方式。是一種異步的、不需要持卡人參與完成的交易類型。因涉及資金的清算，ACP系統(tǒng)均會給請求方后臺通知(后臺通知報文要素同前臺應答的要素)，請求方也必須實現(xiàn)接收后臺通知。對于交易狀態(tài)未知的交易請求方必須發(fā)起交易狀態(tài)查詢交易。圖 11注意：1. 每個交易需要的報文要素是不一樣的，具體每個交易需要的要求，請參考開發(fā)包中接口規(guī)范文檔；2. 圖13中第4步中的應答僅代表該筆后臺請求交易已經受理，不代表全部處理成功；是否處理成功，需通過接受后臺通知或者發(fā)起“交易狀態(tài)查詢交易”進行查詢；3. 第5步后臺應答返回的URL為請求報文中的“backUrl”字段指定的URL。 后臺非資金類交易流程后臺類非資金類交易是指交易請求方（如商戶、收單機構）將交易信息（不涉及資金清算的交易）直接通過請求方服務器發(fā)送至ACP服務器的交易方式。后臺非資金類交易均為同步短連接方式，不需要持卡人參與完成的交易類型。若通