銀聯網關支付接口測試全流程指南(Java + Eclipse + Tomcat)
本文記錄從商戶註冊、證書配置、SDK 導入、參數修改到實際測試支付的完整步驟,適合首次接入銀聯網關支付的 Java 開發者快速跑通測試環境。
一、 準備材料
- 註冊賬號:銀聯開放平台
- 下載「網關支付產品技術開發包」(含文檔、Demo 工程、測試證書)
- 開發環境:Eclipse + Tomcat 7.0+
- 導入 Demo 工程,閱讀
readme.txt 了解目錄結構
二、 核心配置修改
1. 獲取測試參數
登錄後台 → 「我的產品」→「網關支付」→「測試參數」,獲取:
- 商戶號(merId)
- 商戶私鑰證書 → 重命名
acp_test_sign.pfx
- 銀聯公鑰證書 → 重命名
acp_test_verify_sign.cer
- 測試入口地址(前台/後台通知/查詢)
2. 證書部署
D:\certs\
├── acp_test_sign.pfx # 商戶私鑰
├── acp_test_verify_sign.cer # 銀聯公鑰
└── 其他原始測試證書文件
3. 修改 acp_sdk.properties
- 更新請求交易地址為測試環境地址
- 配置證書路徑指向
D:/certs/
- 設置簽名/驗簽算法等參數
4. 批量替換商戶號
全局搜索替換所有 Java 文件中的 merId 為申請的測試商戶號。
三、 測試驗證
- 後台「我的產品」→「網關支付」→「開始測試」,等待 ~10 分鐘生效
- IE 訪問
https://127.0.0.1:8080/ACPSample_B2C/(避免 360 瀏覽器兼容問題)
- 輸入商戶號,點擊「跳轉銀聯支付頁面」,忽略證書安全警告
- 使用測試卡號(平台提供)完成支付,驗證成功回調
常見坑點提示
- 證書路徑區分正反斜槓,Windows 建議雙反斜槓或正斜槓
- 端口衝突時修改
server.xml 中 Tomcat 端口
- 簽名驗簽失敗優先核對證書文件是否對應、merId 是否一致