1、銀聯二維碼技術對接指引1 環境與參數 在實施商戶側上線銀聯云閃付二維碼支付業務時，服務商/商戶要保證每個商戶編號下每個門店至少有一個唯一的終端號（8位），終端編號應采用“門店編號+設備編號（如收銀機）”組成，每筆交易要上送正確的商戶編號+終端編號，終端編號與門店編號的映射關系要提供給銀聯。 1.1 接口規范及開發包銀聯二維碼商戶接入最新的接口規范和開發包均會第一時間發布在銀聯開放平臺上，商戶可以自行下載，下載地址如下：目前開發包中包含JAVA、.NET、PHP三種版本SDK和DEMO，使用其他開發語言需要自行開發。開發包中的DEMO在WEB容器中可以直接運行（需要修改配置文件acp_sdk.p

2、roperties中的各種證書路徑）。對賬文件格式規范也可在銀聯開發平臺下載，下載地址如下：1.2接口地址測試環境被掃消費、主掃申碼、交易撤銷、退款交易狀態查詢（消費、撤銷、退款）對賬文件下載生產環境被掃消費、主掃申碼、交易撤銷、退款交易狀態查詢（消費、撤銷、退款）對賬文件下載1.3參數1.3.1 商戶號測試環境：在銀聯開發平臺（生產環境：商戶與收單機構簽訂收單協議，由收單機構提交申請材料到銀聯，由銀聯分配商戶號。1.3.2 商戶證書及證書密碼交易過程中，需要對請求報文進行簽名處理，防止報文被偽造或者在傳輸過程中被篡改。商戶證書即用于給請求報文簽名。測試環境：使用注冊好的賬號登錄銀聯開發平臺，

3、并下載商戶證書，商戶證書密碼為：000000，具體如下圖所示：生產環境：登錄商戶服務平臺提交服務單申請下發證書，或者聯系銀聯在當地的分公司，由分公司來幫忙申請。銀聯下發證書后需要商戶上CFCA官網下載，具體下載流程見銀聯發送的郵件（證書密碼由商戶在從IE瀏覽器中導出的時候自行設置）。注意：一定要將銀聯下發的商戶證書的公鑰證書上傳到商戶服務平臺，并點擊啟用。1.2.3 驗簽證書銀聯在響應商戶的請求時，也會對響應報文進行簽名，商戶需要驗證響應報文中的簽名，以確保響應報文確實來自銀聯，且未被篡改。在5.1.0版本中，響應報文中會包含用于驗證響應報文簽名的驗簽證書，這就需要商戶不但要驗證報文的簽名，還

4、要驗證響應報文中的驗簽證書是否合法。測試環境和生產環境的驗簽證書都已經打包進開發包了，如上圖所示，acp_test_middle.cer和acp_test_root.cer為測試環境的證書，acp_prod_middle.cer和acp_prod_root.cer為生產環境的證書。1.3.4 敏感信息加密證書商戶接入二維碼不涉及用戶敏感信息，所以暫不需要使用敏感加密證書。 1.3.5 銀行卡測試環境：詳見生產環境：使用真實有效的銀行卡即可。1.4錯誤碼錯誤碼列表及說明詳見：7位詳細錯誤碼列表及說明：2測試數據生產環境：驗證被掃時，掃描銀聯錢包上的二維碼完成驗證；驗證主掃時，使用銀聯錢包掃商戶生

5、產的二維碼來完成支付驗證。測試環境：詳見2.1及2.2。2.1 獲取C2B碼（被掃）在測試環境下，測試被掃時，不能使用銀聯錢包生成的C2B碼，需要使用銀聯開放平臺上的二維碼仿真來生成，銀聯開放平臺二維碼仿真地址如下：如圖上圖所示，得到的qrNo即為被掃時使用的C2B碼，對于使用掃描槍的測試，還需將C2B碼轉為條形碼或者二維碼。2.2 收款碼收款（主掃）當商戶生成收款二維碼時，需要付款方使用銀聯錢包掃碼來完成付款，但是測試環境中不能使用銀聯錢包，需要使用銀聯開放平臺上的二維碼仿真完成付款動作。主掃付款仿真地址：具體操作流程如下：當商戶申請二維碼付款碼時，銀聯后臺會生成一個待支付的訂單，付款方在掃描二維碼準備支付時，需要先從銀聯查詢二維碼對