【導(dǎo)讀】©北京融易通信息技術(shù)有限公司1/35. 融易通支付平臺(tái)接口使用手冊(cè)。版本號(hào)日期修改人摘要。檔，增加說明注釋,修改批量退款

　　

【正文】 退款格式： txt 文件， 按順序（ 融易通流水號(hào) ,退款金額）排列，中間用逗號(hào)隔開，一行一條記錄，如下： 10232,200 10233,300 10235,100 融易通對(duì)賬 單下載說明 對(duì)賬單格式說明： 格式： 第一行 ： TRADEDETAILSTART,7633,20200630,6,S TRADEDETAILSTART：開始標(biāo)示字符 7633：商戶號(hào) 20200630 下載日期， 6，總下載記錄數(shù) S,F 下載成功失敗標(biāo)示 169。 北京融易通信息技術(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ì)帳）。 1– 勾對(duì)成功，雙方均成功。 2– 勾對(duì)失敗，雙方金額不符 3– 勾對(duì)失敗，銀行為可疑交易） 結(jié)尾行 TRADEDETAILEND TRADEDETAILEND：結(jié)束標(biāo)示字符 對(duì)賬單示例如下： TRADEDETAILSTART,7633,20200630,6,S 7633,FT00001,20200629,12,10294,20200629,1,2,1 7633,FT00002,20200629,12,10295,20200629,1,2,1 7633,FT00003,20200629,12,10296,20200629,1,2,1 7633,FT00004,20200629,12,10297,20200629,1,2,1 7633,FT00005,20200629,12,10298,20200629,1,2,1 7633,FT00006,20200629,12,10299,20200629,1,2,1 TRADEDETAILEND 169。 北京融易通信息技術(shù)有限公司 29/35 網(wǎng)上支付處理結(jié)果異步返回參數(shù) 參數(shù)描述：對(duì)于網(wǎng)上支付交易，銀行處理完畢會(huì)異步返回處理結(jié)果，返回的參數(shù)名稱、含義如下表所示。 參數(shù) 參數(shù)名稱 非空 長(zhǎng)度 備注 merId 商戶編號(hào) Y 為商戶分配的唯一編號(hào) ordId 訂單號(hào) Y 由商戶自定，保證一天內(nèi)的唯一性即 可 transDate 商戶交易日期 Y 8 格式為 YYYYMMDD, 商戶原始支付交易的商戶日期。 transAmt 訂單金額 Y 12 單位 :元 并帶兩位小數(shù) 10 位整數(shù) +2 位小數(shù) transStat 交易狀態(tài) Y 1 S— 成功 F— 失敗 gateId 網(wǎng)關(guān) Y 系統(tǒng)為銀行支付通道定義的唯一標(biāo)志號(hào)。 merPriv 商家 N 120 商戶可以用此域放置商戶私有信息，系統(tǒng)不會(huì)對(duì)該域進(jìn)行任何修改，在返回交易應(yīng)答時(shí)，同時(shí)將該數(shù)據(jù)返回給商戶。 tseq 融易通系統(tǒng)流水號(hào) Y 融易通系統(tǒng)流水 號(hào) bankTime 銀行響應(yīng)時(shí)間 Y UTC 時(shí)間 errorMsg 交易失敗信息 N 交易失敗時(shí)提示的信息 pSigna 簽名后的字符串 Y 120 由（ ordId + merId + transAmt + transDate+ tseq ）得到的簽名字符串 169。 北京融易通信息技術(shù)有限公司 30/35 退款運(yùn)行經(jīng)辦 處理結(jié)果異步返回參數(shù) 參數(shù)描述：對(duì)于 退款申請(qǐng) ， 管理員經(jīng)辦 完畢會(huì)異步返回處理結(jié)果，返回的參數(shù)名稱、含義如下表所示。 參數(shù) 參數(shù)名稱 非空 長(zhǎng)度 備注 merId 商戶編號(hào) Y 6 為商戶分配的唯一編號(hào) ordId 訂單號(hào) Y 16 原始訂單號(hào) merDate 商戶訂單日期 Y 8 格式為 YYYYMMDD, 商戶原始支付交易的商戶日期。 transType 交易類別 Y 固定 R R－退款交易 transAmt 訂單金額 Y 12 原始訂單支付金額，單位 :元 并帶兩位小數(shù) 10 位整數(shù) +2 位小數(shù) refundAmt 退款金額 Y 12 申請(qǐng)退款的金額 reffundCount 總退款金額 reffundDate 退款日期 經(jīng)辦當(dāng)天日期 tseq 原訂單融易通流水號(hào) refundState 退款狀態(tài) Y 1 S 退款成功。 C 退款撤銷 pSigna 簽名 Y 256 明文字符串為merId+ordId + merDate + transAmt + refundAmt +reffundDate+tseq。 充值消費(fèi)卡支付接口 接口描述：商戶一次提交訂單信息和卡信息進(jìn)行支付，請(qǐng)求成功 返回支付交易結(jié)果的 xml,驗(yàn)證簽名顯 示詳細(xì)信息；否則返回錯(cuò)誤提示信息 xml。 參數(shù) 參數(shù)名稱 非空 長(zhǎng)度 備注 version 消息版本號(hào) Y 2 固定為 10 merId 商戶編號(hào) Y 為商戶分配的唯一編號(hào) ordId 訂單號(hào) Y 由商戶自定，保證一天內(nèi)的唯一性即可。 169。 北京融易通信息技術(shù)有限公司 31/35 orderDate 商戶訂單日期 Y 8 格式為 YYYYMMDD transType 交易類別 Y 1 固定為 T transAmt 訂單金額 Y 12 單位為元，精確到分，比如 gateId 渠道 網(wǎng)關(guān) Y 見附錄一 phoneNo 手機(jī)號(hào)碼 N 用于接受支付結(jié)果，融易付將把支付結(jié)果發(fā)短信到該手機(jī)號(hào) bgRetUrl 后臺(tái)交易應(yīng)答接收地址 Y 120 支付完成后，支付網(wǎng)關(guān)會(huì)按照此地址將交易結(jié)果以后臺(tái)的方式發(fā)送到商戶網(wǎng)站。 為保證商戶能收到交易的返回應(yīng)答， account 充值卡卡號(hào)碼 （序列號(hào)） Y 30 password 充值卡密碼 Y selectAmount 充值卡面額 Y 8 若為余額卡，請(qǐng)將余額卡面額置為卡余額或卡面額。 chkValue 商家簽名 Y 256 參與數(shù)字簽名的字符串為 version + merId + ordId + orderDate+ transType +transAmt + gateId +bgRetUrl+account+ password 成功 返回 XML 結(jié)構(gòu) ?xml version= encoding=utf8? res 169。 北京融易通信息技術(shù)有限公司 32/35 status value0/value!—根據(jù) value 判斷處理是否成功， 0成功 1失敗 msg錄入 成功 /msg /status transResult !—交易結(jié)果 merIdmerId/merId!—商戶號(hào) ordId ordId / ordId !—商戶提交訂單號(hào) transAmttransAmt/transAmt!—交易金額 transType transType /transType!—交易類型 ,詳見參數(shù)列表 gateIdgateId/gateId!—銀行網(wǎng)關(guān) transStattransStat/transStat!交易狀態(tài) ,0初始化 1錄入成功 2支付成功 3失敗 tseqtseq/tseq !—對(duì)應(yīng)支付融易通訂單流水號(hào) chkValuechkValue/chkValue!—簽名 項(xiàng) merId + ordId + transAmt + transType + gateId +transStat+tseq。 /transResult /res 失敗返回 XML 結(jié)構(gòu) ?xml version= encoding=utf8? res status value1/value! 錯(cuò)誤代碼 msgmsg/msg! 錯(cuò)誤提示信息 /status /res 5 補(bǔ)充說明 提交返回接口驗(yàn)證事項(xiàng) 為確保訂單安全，商戶在收到訂單提交返回時(shí)，請(qǐng)包括如下驗(yàn)證步驟： 1. 判斷返回 xml 中 value 值 根據(jù)返回的 value 值判斷操作是否成功，如失敗則此時(shí)無需再進(jìn)行以下步驟。 2. 數(shù)據(jù)驗(yàn)證 可以使用融易通 提供的簽名驗(yàn)證組件，對(duì)返回的關(guān)鍵信息進(jìn)行驗(yàn)證，以確保訂單信息 安全，防止黑客惡意攻擊及篡改訂單信息。 3. 判斷訂單號(hào)和金額 為安全起見，商戶應(yīng)該將自己 系統(tǒng)中存放的訂單信息和 融易通 返回的訂單信息進(jìn)行比對(duì)， 以保證訂單數(shù)據(jù)真實(shí)可信。建議比對(duì)的項(xiàng)：訂單編號(hào)和訂單金額。 4. 在成功完成以上步驟后，商戶可以根據(jù)需要進(jìn)行其他操作。 169。 北京融易通信息技術(shù)有限公司 33/35 支付返回接口驗(yàn)證事項(xiàng) 為確保交易安全，商戶在收到融易通交易支付返回時(shí)，請(qǐng)包括如下驗(yàn)證步驟： 1. 判斷返回 xml 中 value 值 根據(jù)返回的 value 值判斷操作是否成功，如失敗則此時(shí)無需再進(jìn)行以下步驟。 2. 數(shù)據(jù)驗(yàn)證 可以使用融易通提供的簽名驗(yàn)證組件，對(duì)返回的關(guān)鍵信息進(jìn)行驗(yàn)證，以確保交易數(shù)據(jù) 安全，防止黑客惡意攻擊及篡改交 易數(shù)據(jù) 。 3. 判斷訂單號(hào)和金額 為安全起見，商戶應(yīng)該將自己系統(tǒng)中存放的訂單信息和融易通返回的訂單信息進(jìn)行比對(duì)， 以保證訂單數(shù)據(jù)真實(shí)可信。建議比對(duì)的項(xiàng)：訂單編號(hào)和訂單金額。 4. 在成功完成以上步驟后，商戶可以根據(jù)需要進(jìn)行其他操作。 補(bǔ)充說明 :請(qǐng)使用 MD5WITHRSA驗(yàn)證方式 ,此方式簽名是不能偽造的 注意事項(xiàng)： 1 在使用 Web 接口方式開發(fā)時(shí)，請(qǐng)勿使用框架方式進(jìn)行嵌套，否則可能會(huì)在銀行端發(fā)生無法支付的錯(cuò)誤。 2 由于網(wǎng)速問題可能會(huì)出現(xiàn)支付返回快與提交返回 ,所以返回頁(yè)面判斷時(shí)要兼容這種情況 . 3 加解密完 成時(shí)可能會(huì)現(xiàn)非法字符導(dǎo)致融易通解密失敗 ,建議替換掉相關(guān)字符 ,如 在 linux 下的回車鍵 “\n”，在 windows 下的回車鍵 “\r\n”,字符串結(jié)束符號(hào) “\0”. 示例程序 詳見融易通支付平臺(tái)商戶開發(fā)示例程序 附錄一 融易付支付網(wǎng)關(guān)列表 網(wǎng)上非直連銀行網(wǎng)關(guān) 網(wǎng)關(guān)號(hào) 網(wǎng)關(guān)名稱 15 北京銀行 40 北京農(nóng)村商業(yè)銀行 48 東亞銀行 49 南京銀行 169。 北京融易通信息技術(shù)有限公司 34/35 51 郵政儲(chǔ)蓄 81 杭州銀行 84 上海銀行 87 平安銀行 311 順德農(nóng)村信用合作社 10001 交通銀行 10400 工商銀行 10300 招商銀行 10605 建設(shè)銀行 12100 中國(guó)銀行 10500 農(nóng)業(yè)銀行 10900 浦發(fā)銀行 11100 廣東發(fā)展銀行 12200 中信銀行 12400 光大銀行 10800 興業(yè)銀行 11000 深圳發(fā)展銀行 10700 民生銀行 11300 華夏銀行 11800 廣州市商業(yè)銀行 11700 深圳市農(nóng)村商業(yè)銀行 11500 上海農(nóng)村商業(yè)銀行 11600 廣州市農(nóng)村信用社 信用卡直連銀行網(wǎng)關(guān) 網(wǎng)關(guān)號(hào) 網(wǎng)關(guān)名稱 80001 工商 銀行 80002 中國(guó)銀行 80003 興業(yè)銀行 80004 建設(shè)銀行 80008 廣東發(fā)展銀行 80009 光大銀行 80010 民生銀行 80012 浦發(fā)銀行 80013 上海銀行 80014 中信銀行 WAP 支付銀行網(wǎng)關(guān) 網(wǎng)關(guān)號(hào) 網(wǎng)關(guān)名稱 90000 招商銀行 90001 交通銀行 90002 工商銀行 169。 北京融易通信息技術(shù)有限公司 35/35 手機(jī)充值卡支付渠道網(wǎng)關(guān) 網(wǎng)關(guān)號(hào) 網(wǎng)關(guān)名稱 60000 全國(guó)移動(dòng)充值卡 60001 全國(guó)聯(lián)通一卡充 60002 全國(guó)電信卡 60003 天下通卡