【正文】 ES密鑰，然后用該密鑰解密 pstr得到參數(shù)串tarnstype=TransTypeamp。 其中 ChkValue 的值為 Version + MerId + OrdId + TransAmt + MerDate + TransType + GateId + MerPriv + RetUrl + BgRetUrl 字符串經(jīng)過 MD5生成的 Hash值，再經(jīng)過商戶的私鑰加密生成的字符串。transAmt=TransAmtamp。 本次請(qǐng)求的請(qǐng)求參數(shù)串為假設(shè)為：tarnstype=TransTypeamp。該設(shè)備以硬件為基礎(chǔ)，將防火墻虛擬專用網(wǎng) VPN 和流量管理系統(tǒng)等幾類功能集成到一個(gè)產(chǎn)品上，確保 融易通支付網(wǎng)關(guān)免于病毒和黑客攻擊，避免由于網(wǎng)絡(luò)產(chǎn)生的新漏洞受到 威脅，為商戶交易的機(jī)密數(shù)據(jù)提供了保護(hù)措施，保證平臺(tái)安全穩(wěn)定。換言之，一個(gè)防火墻在一個(gè)被認(rèn)為是安全和可信的內(nèi)部網(wǎng)絡(luò)和一個(gè)被認(rèn)為是不那么安全和可信的外部網(wǎng)絡(luò)（通常是 Inter）之間提供一個(gè)封鎖工具。 注：非直連支付：將支付請(qǐng)求及訂單信息轉(zhuǎn)發(fā)至銀行頁面，再由銀行異步返回處理結(jié)果。 1 簡介 融易通支付平臺(tái)簡介 融易通支付平臺(tái)是一個(gè)功能強(qiáng)大基于網(wǎng)絡(luò)的在線支付平臺(tái)，由融易通信息技術(shù)有限公司研發(fā)完成，以其自身個(gè)性化的設(shè)計(jì)為客戶提供了方便、安全、多渠道的在線支付服務(wù)。 北京融易通信息技術(shù)有限公司 1/35 融易通支付平臺(tái)接口使用手冊(cè) 版本 V 169。 北京融易通信息技術(shù)有限公司 2/35 文檔信息 修訂歷史 版本號(hào) 日期 修改人 摘要 20202005 袁志勇 在 ，文檔，增加說明注釋 ,修改批量退款格式。目前該產(chǎn)品已投入使用之中，其快捷、安全的交易模式將會(huì)普遍被商家所接受。 直連支付：融易通內(nèi)部完成與銀行的交互，無需用戶與銀行直接交互。它是保護(hù)和連接一個(gè)網(wǎng)絡(luò)到另一個(gè)網(wǎng)絡(luò)的設(shè)備，保護(hù)網(wǎng)絡(luò)服務(wù)器不被外部非法授權(quán)者使用，按照預(yù)定規(guī)則控制數(shù)據(jù)包的進(jìn)出，是內(nèi)外網(wǎng)絡(luò)之間的屏障。 融易通數(shù)據(jù)傳輸加解密流程 對(duì)于有加密需求的請(qǐng)求，我們初步設(shè)計(jì)雙方通信過程如下： 請(qǐng)求方請(qǐng)求格式為 k=xxxamp。version=Versionamp。merDate=MerDateamp。 請(qǐng)求參 數(shù)串通過 DES密鑰加密后生成 pstr。version=Versionamp。merDate=MerDateamp。 例如 :下面方法的作用就是對(duì)請(qǐng)求中涉及的數(shù)據(jù)加密，然后調(diào)用 請(qǐng)求，獲取返回值 。 北京融易通信息技術(shù)有限公司 7/35 //通 過 rsa私 鑰簽 名 String chk = (((), privateKey))。 //用 rsa公 鑰 加密 對(duì) des密 鑰進(jìn) 行加密 byte[] data = ((), publicKey)。 (k, k)。 } 網(wǎng)上支付交易返回接口的數(shù)字簽名認(rèn)證 數(shù)字簽名認(rèn)證的目的是用來保證信息傳輸過程中信息的完整性和真實(shí)性以及提供信息發(fā)送者身份的確認(rèn)證。 對(duì)于頁面返回方式，平臺(tái)無法知道商戶是否成功收到交易結(jié)果。 169。 商戶向平臺(tái)下訂單 (調(diào)用支付頁面接口 ) 商戶提交支付信息，進(jìn)入融易通支付頁面進(jìn)行支付操作，并在融易通支付頁面顯示支付結(jié)果。 北京融易通信息技術(shù)有限公司 10/35 有信息，系 統(tǒng)不會(huì)對(duì)該域進(jìn)行任何修改，在返回交易應(yīng)答時(shí)，同時(shí)將該數(shù)據(jù)返回給商戶。當(dāng)銀行網(wǎng)關(guān)沒有指定時(shí)，返回選擇銀行網(wǎng)關(guān) xml；當(dāng)網(wǎng) 關(guān)已指定并且選擇直連支付 (信用卡支付 )時(shí)返回 信用卡號(hào)等 信息填寫 xml。 參數(shù) 參數(shù)名稱 非空 長度 備注 Version 消息版本號(hào) Y 2 固定為 10 merId 商戶編號(hào) Y 為商戶分配的唯一編號(hào) ordId 訂單號(hào) Y =20 由商戶自定，保證一天內(nèi)的唯一性即可。 merPriv 商家 私有域 N 120 商戶可以用此域放置商戶私有信息，系統(tǒng)不會(huì)對(duì)該域進(jìn)行任何修改，在返回交易應(yīng)答時(shí)，同時(shí)將該數(shù)據(jù)返回給商戶。 transPeriod 訂單有效期 N 提交訂單有效期 chkValue 商家簽名 Y 256 商戶發(fā)生命令參與數(shù)字簽 名 的 字 符 串 為Version + MerId + OrdId + TransAmt + orderDate + TransType + GateId + MerPriv + RetUrl + BgRetUrl 交易類別 transType 為 P 或 C（支付交易）時(shí) 當(dāng)銀行網(wǎng)關(guān)沒有指定時(shí) 返回內(nèi)容說明 支付網(wǎng)關(guān)信息 返回 XML 結(jié)構(gòu) ?xml version= encoding=utf8? res 169。 label=39。 label=39。 label=39。 label=39。 label=39。 label=39。 label=39。 label=39。 label=39。此處銀行網(wǎng)關(guān)已制定，只會(huì)有一個(gè) bank標(biāo)簽 bank gateIdgateId/gateId!—銀行網(wǎng)關(guān) namename/name !—網(wǎng)關(guān)名稱 logoUrl logoUrl logoUrl!—銀行 logo 圖片的地址 !—以下是銀行信息填寫頁面信息 input type=”text” name=”account” label=”信用卡號(hào) ”/ input type=”text” name=”cvv” label=”cvv”/ input type=”password” name=”pwd” label=”密碼 ”/ input name=”period” label=”卡有效期 ”/ input name=”useName” label=”持卡人姓名 ”/ radio name=”pIdType” label=”證件類型 ” value v=39。/value value v=39。 /value value v=39。 /value value v=39。 /value value v=39。 /value value v=39。 /value value v=39。 /value value v=39。 /value value v=39。 /value input type=”text” name=”pIdNo” label=”證件證號(hào) ”/ input type=”text” name=” phoneNo” label=”手機(jī)號(hào)碼 ”/ /bank /payInfo /res 網(wǎng)上直連信用卡支付提交銀行賬號(hào)信息接口 ? 接口描述 ：支付方式為信用卡直連時(shí)，輸入銀行賬號(hào)信息提交支付。 ? 提交賬號(hào)信息的測試 URL 地址 : 提交賬號(hào)信息的正式 URL 地址 : ? 調(diào)用 請(qǐng)求方法，并獲取返回值 ,以下是接口所需的參數(shù)列表 參數(shù) 參數(shù)名稱 非空 備注 tseq 支付融易通訂單流水號(hào) Y account 卡號(hào) Y 信用卡號(hào) cvv 貸記卡 CVV Y 信用卡必輸 period 貸記卡有效期 Y 格式為 MM/YY 如 12/09 password 交易密碼 N 為 已加密 數(shù)據(jù) gateId 銀行網(wǎng)關(guān) Y pName 持卡人姓名 Y 信用卡必輸 pIdType 持卡人證件類型 Y 持卡人證件類型 : 1 身份證 169。 北京融易通信息技術(shù)有限公司 17/35 status value1/value! 錯(cuò)誤代碼 msgmsg/msg! 錯(cuò)誤提示信息 /status /res 網(wǎng)上非直連支付銀行選擇提交接口 ? 接口描述：對(duì)于網(wǎng)上非直連支付交易，選擇銀行網(wǎng)關(guān)，進(jìn)行下一步，則會(huì)連同訂單信息一起轉(zhuǎn)發(fā)至相應(yīng)的銀行頁面。 169。 transType 交 易類別 Y 1 A－信用卡 一站 支付交易 transAmt 訂單金額 Y 12 單位 :元 10 位整數(shù) +2 位小數(shù) gateId 網(wǎng)關(guān) Y 系統(tǒng)為銀行支付通道定義的唯一標(biāo)志號(hào)。 bgRetUrl 后臺(tái)交易應(yīng)答接收地址 Y 120 支付完成后，支付網(wǎng)關(guān)會(huì)按照此地址將交易結(jié)果以后臺(tái)的方式發(fā)送到商戶網(wǎng)站。 北京融易通信息技術(shù)有限公司 21/35 ?xml version= encoding=utf8? res status value1/value! 錯(cuò)誤代碼 msgmsg/msg! 錯(cuò)誤提示信息 /status /res 手機(jī) WAP 頁面支付接口 商戶在手機(jī)端提交支付信息，把手機(jī)瀏覽器重定向融易通支付平臺(tái)，并在融易通手機(jī)支付頁面顯示支付結(jié)果。 gateId 網(wǎng)關(guān) N 如果 gateId 為空，將跳轉(zhuǎn)到融易通的選擇網(wǎng)頁的頁面，如果不為空將直接跳轉(zhuǎn)到對(duì)應(yīng)的銀行頁面。 有別于 WEB 方式的取貨通知，手機(jī)支付平臺(tái)將不回傳任何參數(shù)以避免手機(jī)瀏覽器通訊量過大。用戶打開支付鏈接，顯示支付頁面完成支付。 transAmt 訂單金額 Y 12 單位 :元 merPriv 商家 N 120 商戶可以用此域放置商戶私有信息，系統(tǒng)不會(huì)對(duì)該域進(jìn)行任何修改，在返回交易應(yīng)答時(shí)，同時(shí)將該數(shù)據(jù)返回給商戶。 北京融易通信息技術(shù)有限公司 24/35 /status transResult tseq Tseq/tseq !— 該交易訂單在融易付系統(tǒng)的流水 merIdmerId/merId!— 商戶號(hào) merDatemerDate/merDate!— 訂單提交日期 ordId ordId / ordId !— 商戶提交訂單號(hào) transAmttransAmt/transAmt!— 交易金額 url RequestUrl /url!— phoneNo 為空時(shí)返回支付鏈接；不為空時(shí)如果融易付發(fā)送到該手機(jī)號(hào)支付鏈接成功返回該手機(jī)號(hào)，發(fā)送失敗將返回支付鏈接 /transResult /res 失敗返回 XML 結(jié)構(gòu) ?xml version= encoding=utf8? res status value1/value! 錯(cuò)誤代碼 msgmsg/msg! 錯(cuò)誤提示信息 /status /res 融易通 聯(lián)機(jī)單筆查詢 接口 參數(shù) 參數(shù)名稱 非空 長度 備注 merId 商戶編號(hào) Y 為商戶分配的唯一編號(hào) ordId 訂單號(hào) Y 要查詢訂單的訂單號(hào) orderDate 商戶訂單日期 Y 8 格式為 YYYYMMDD, transType 交易類別 Y 1 L－ 聯(lián)機(jī)查詢 chkValue 商家簽名 Y 256 商戶發(fā)生命令參與數(shù)字簽名的字符串為 merId + ordId + merDate + transType 返回內(nèi)容說明 返回 XML 結(jié)構(gòu) 169。 transType 交易類別 Y 1 R－退款交易 transAmt 訂單金額 Y 12 原始訂單支付金額， 單位 :元 并帶兩位小數(shù) 10 位整數(shù) +2 位小數(shù) refundAmt 退款金額 Y 12 申請(qǐng)退款的金額 bgRetUrl 后臺(tái)交易應(yīng)答 接收地址，主動(dòng)通知 URL。 北京融易通信息技術(shù)有限公司 28/35 內(nèi)容行： 7633，商戶號(hào) FT00001，商戶訂單號(hào) 20200629，商戶日期 ，交易金額 12，手續(xù)費(fèi) 10294，融易通流水號(hào) 20200629，交易日期 1，交易類型（ 1－網(wǎng)上支付 3－信用卡支付 4－退款 6－ B2B 協(xié)議支付 7－ B2B 網(wǎng)上支付 8— 手機(jī) WAP 支付） 2，訂單狀態(tài)（ 1– 錄入成功等待銀行處理 2– 支付成功 3– 失?。? 1，對(duì)賬標(biāo)志（ 0– 初始狀態(tài)（未對(duì)帳）。 參數(shù) 參數(shù)名稱