銀行系統(tǒng)b2b在線支付(新接口)手冊(cè)-資料下載頁
2024-10-19 12:36本頁面
【導(dǎo)讀】序的接口；及調(diào)試用的例子。為此商戶網(wǎng)站必須將該訂單中的部分信息以Form提交方式中的Post方法，行確認(rèn)投產(chǎn)環(huán)境和測(cè)試環(huán)境的IP地址)中。接口名稱APINameMAX必輸，簽名，上送“B2B”，區(qū)別大小寫！工行通過訂單號(hào)加訂單日期來唯一。確認(rèn)一筆訂單的重復(fù)性。工行只支持人民幣支付。商戶證書數(shù)據(jù)字串。交易日期時(shí)間TranTime=14必輸，簽名，YYYYMMDDHHmmss。>中submit不能有Name屬性)；此外，如果其他input項(xiàng)的。，商戶請(qǐng)求的數(shù)據(jù)字符集要求是GBK。收款賬號(hào)必須為集團(tuán)在網(wǎng)銀注冊(cè)的可收款的19位賬號(hào)，此接口不支持低。于19位的老賬號(hào)。
【正文】 ime=接收交易日期時(shí)間 amp。NotifyTime=返回通知日期時(shí)間 amp。 Shop_acc_num =商城賬號(hào) amp。 PayeeAcct =收款單位賬號(hào) amp。 PayeeName =收款單位名稱 amp。ShopRem=商城備注字段 商城網(wǎng)站接收到該請(qǐng)求，取出數(shù)字簽名信息，先使用工行提供的 API 對(duì)數(shù)字簽名進(jìn)行Base64 解碼，然后使用工行提供的 API 驗(yàn)證簽名，如果簽名驗(yàn)證正確，說明該筆通知信息有效。商戶應(yīng)根據(jù)自己的業(yè)務(wù)邏輯對(duì)交易通知信息進(jìn)行處理（注意：這里的交易通知信息可能為失敗也可 能為成功，而且一筆訂單可能會(huì)產(chǎn)生多筆通知信息，但最多只可能有一個(gè)成功通知信息）。 通知消息中的的簽名信息 的產(chǎn)生（使用工商銀行私鑰簽名）和 BASE64 編碼的實(shí)現(xiàn)由工行交易平臺(tái)產(chǎn)生，商戶不需要關(guān)心；商戶要關(guān)心的是如何對(duì)通知信息中的簽名信息BASE64 解碼，然后用工行的證書驗(yàn)證簽名。 網(wǎng)上銀行商戶手冊(cè) 169。Copyright ICBC SDC 11 驗(yàn)證簽名信息 簽名信息 NotifySign 的驗(yàn)證要經(jīng)過如下幾個(gè)步驟： 1． 取原始數(shù)據(jù)： 原始數(shù)據(jù)為： APIName=接口名稱 amp。APIVersion=接口版本號(hào) amp。Shop_code=商戶代碼 amp。MerchantURL=支付結(jié)果信息通知 程序地址 amp。Serial_no=指令序號(hào) amp。PayStatusZHCN=訂單處理狀態(tài) amp。TranErrorCode=錯(cuò)誤代碼amp。TranErrorMsg=錯(cuò)誤描述 amp。ContractNo=訂單號(hào) amp。ContractAmt=訂單金額 amp。Account_cur=支付幣種amp。JoinFlag= 檢 驗(yàn) 聯(lián)名 標(biāo) 志 amp。ShopJoinFlag=商 城 聯(lián)名 標(biāo) 志 amp。CustJoinFlag=客 戶 聯(lián)名 標(biāo) 志amp。CustJoinNumber=聯(lián)名 會(huì)員 號(hào) amp。SendType=結(jié) 果發(fā) 送類 型 amp。TranTime=接 收交 易日 期時(shí)間amp。NotifyTime=返回通知日期時(shí) 間 amp。Shop_acc_num=商城賬號(hào) amp。PayeeAcct=收款單位賬號(hào) amp。PayeeName=收款單位名稱 2．取簽名數(shù)據(jù)： 簽名數(shù)據(jù)：簽名數(shù)據(jù)就是以 NotifySign 為屬性名的屬性值，它們以 NotifySign =“簽名信息” 的形式在 請(qǐng)求中存在。 3． 調(diào)用 API 統(tǒng)一接口對(duì)簽名數(shù)據(jù)進(jìn)行 BASE64 解碼，得到簽名信息。接口如下： C 接口 int base64dec(char *src, int srcLen, unsigned char **dst, int *dstLen) 參數(shù)說明： src 源數(shù)據(jù)，其長(zhǎng)度為： srcLen。 dst 為編碼后的數(shù)據(jù)，長(zhǎng)度存放在： dstLen dst 的存儲(chǔ)空間由接口申請(qǐng)，應(yīng)用釋放 返回： 0 正確， 1 錯(cuò)誤 JAVA 接口 byte[] base64dec(byte [] src) 參數(shù)說明： src 源數(shù)據(jù) 返回：正確 編碼后數(shù)據(jù)，錯(cuò)誤 null 4． 調(diào)用 API 統(tǒng)一接口驗(yàn)證 BASE64 解碼后得到的簽名信息，接口如下： C 接口 int verifySign( char *src, int srcLen, unsigned char *cert, int certLen, 網(wǎng)上銀行商戶手冊(cè) 169。Copyright ICBC SDC 12 unsigned char *signBuf, int signBufLen)。 參數(shù)說明： src 為原始數(shù)據(jù)，其長(zhǎng)度為： srcLen。 cert 為簽名者的證書，長(zhǎng)度為： certLen signBuf 為簽名數(shù)據(jù)，長(zhǎng)度為： signBufLen。 返回： 0 正確，－ 1 錯(cuò)誤 JAVA 接口 int verifySign(byte[] src, int srcLen, byte[] cert, byte[] sign)。 參數(shù)說明： src 為原始數(shù)據(jù)，長(zhǎng)度為 :srcLen。 cert 為簽名者的證書 sign 為簽名數(shù)據(jù) 返回： 成功： 0 失?。浩渌? 5． 驗(yàn)證簽名完畢。 到此，商城訂單支付和工商銀行網(wǎng)上銀行的接口已經(jīng)實(shí)現(xiàn)。 3. 商戶端系統(tǒng)環(huán)境要求 軟件環(huán)境 工行提供的 API 目前包括 Windows， Solaris7， Solaris8， Linux， AIX， HPUX 平臺(tái)上 C和 JAVA 的版本，并將在今后提供更多平臺(tái)的 API 供商戶選用。 由于工行提供的 JAVA API 底層調(diào)用了 C 語言的 API，因此不是純的 JAVA，不能跨平臺(tái)使用，但不影響商戶開發(fā) ，請(qǐng)商戶選用合適自己平臺(tái)的 JAVA API。 4. 常見問題 問題 1 返回一個(gè)空白頁面， 頁面中 只有五位錯(cuò)誤代碼 40987 接口名錯(cuò)誤，請(qǐng)確認(rèn)接口名稱是不是上送的 ”B2B” 網(wǎng)上銀行商戶手冊(cè) 169。Copyright ICBC SDC 13 首先，請(qǐng)仔細(xì) 檢查上送數(shù)據(jù)中是不是有多余的數(shù)據(jù)項(xiàng)，上送數(shù)據(jù)項(xiàng)命名是不是跟文檔中一致（注意 數(shù)據(jù)項(xiàng)名前后 是否有空格）， form和提交按鈕是否有 name屬性。 如果沒問題聯(lián)系工行支持人員。 問題 2 返回超時(shí)頁面 首先，請(qǐng)仔細(xì)檢查上送數(shù)據(jù)中是不是有多余的數(shù)據(jù)項(xiàng)，上送數(shù)據(jù)項(xiàng)命名是不是跟文檔中一致（注意數(shù)據(jù)項(xiàng)名前后是 否有空格）， form和提交按鈕是否有 name屬性。 如果沒問題聯(lián)系工行支持人員。
公司管理相關(guān)推薦
鄂ICP備17016276號(hào)-1