支付寶網(wǎng)銀接入業(yè)務(wù)規(guī)范v103-資料下載頁(yè)
2025-04-12 06:49本頁(yè)面
【正文】 上傳清算對(duì)賬文件。如果上傳文件失敗，銀行應(yīng)當(dāng)有恰當(dāng)?shù)闹卦嚥呗浴Ｈ缬鑫募蟼鳟惓；驗(yàn)榭諘r(shí)，銀行可通知支付寶刪除原文件，銀行再次進(jìn)行上傳。3. 銀行以清算對(duì)賬日期、時(shí)間與文件名等信息構(gòu)造“清算對(duì)賬”通知報(bào)文，告知支付寶清算對(duì)賬文件已上傳。如果發(fā)送失敗，銀行應(yīng)該有恰當(dāng)?shù)闹卦嚥呗浴?. 支付寶收到“清算對(duì)賬”通知報(bào)文后，從銀行提供的清算對(duì)賬文件中解析出每一條網(wǎng)銀交易記錄，與自己在該對(duì)賬日期的所有網(wǎng)銀交易記錄進(jìn)行逐筆核對(duì)。找出并生成以下三類(lèi)交易記錄的清單。n A：銀行有，但支付寶沒(méi)有的交易記錄n B：支付寶有，但銀行沒(méi)有的交易記錄n C：雙方都有，但內(nèi)容不一致的交易記錄支付寶對(duì)不一致的網(wǎng)銀交易記錄進(jìn)行恢復(fù)與處理。對(duì)于A類(lèi)交易記錄，支付寶進(jìn)行交易恢復(fù)，使支付寶對(duì)該筆交易的資金處理與銀行一致。對(duì)于B類(lèi)交易記錄與C類(lèi)交易記錄，支付寶人工介入處理，通過(guò)核對(duì)原始的銀行應(yīng)答指令，找出原因并確定該由哪方進(jìn)行訂正。如果存在需要銀行進(jìn)行調(diào)整的交易記錄，則支付寶線下提供給銀行的需要調(diào)整的交易記錄清單，以及原始的銀行應(yīng)答指令，由銀行在人工核實(shí)之后進(jìn)行處理。 交互模式在清算對(duì)賬業(yè)務(wù)中，銀行與支付寶通過(guò)文件上傳模式交互。在清算對(duì)賬處理流程的第3步，銀行作為文件提供者向支付寶上傳文件，并發(fā)送 “清算對(duì)賬”通知報(bào)文。 業(yè)務(wù)要素T日日終后，由銀行生成T日資金對(duì)賬文件，并將文件上傳到支付寶網(wǎng)銀對(duì)賬文件服務(wù)器。文件頭數(shù)據(jù)要素：要素名稱(chēng)英文縮寫(xiě)要素要求總筆數(shù)TotalNumberl 必須要素，總筆數(shù)總金額TotalAmountl 必須要素，總金額，在接口文檔中要詳細(xì)說(shuō)明該要素單位，是元還是分，還是千分位格式。成功總筆數(shù)SuccessNumberl 必須要素，成功總筆數(shù)成功總金額SuccessAmountl 必須要素，成功總金額，在接口文檔中要詳細(xì)說(shuō)明該要素單位，是元還是分，還是千分位格式。清算日期SettleDatel 必須要素，格式為：yyyyMMddl 若銀行每天提供一個(gè)對(duì)賬文件則文件內(nèi)所有明細(xì)使用同一個(gè)SettleDatel 若銀行好幾天的數(shù)據(jù)匯總到一個(gè)文件中則該要素可以不填，要注明該要素會(huì)在明細(xì)中體現(xiàn)。文件明細(xì)數(shù)據(jù)要素：要素名稱(chēng)英文縮寫(xiě)要素要求清算流水號(hào)SerialNumberl 必須要素，同支付時(shí)的流水號(hào)要求清算金額RealAmountl 必須要素，銀行實(shí)際清算成功金額，在接口文檔中要詳細(xì)說(shuō)明該要素單位，是元還是分，還是千分位格式。清算日期SettleDatel 必須要素，格式為：yyyyMMddl 銀行清算日期。做充退時(shí)用來(lái)定位其實(shí)際日期。清算狀態(tài)SettleStatusl Y 成功；N 失敗，必須要素，默認(rèn)出現(xiàn)的即為成功的交易l 對(duì)賬文件中的數(shù)據(jù)狀態(tài)一定要是穩(wěn)定狀態(tài)。不允許出現(xiàn)處理中的狀態(tài)。失敗原因O如果處理狀態(tài)為失敗，則描述失敗的原因。交易金額R見(jiàn)金額格式說(shuō)明交易貨幣代碼O默認(rèn)為人民幣清算業(yè)務(wù)類(lèi)型SettleType必須要素，0提現(xiàn)。 1支付。 2退貨幣種Currencyl 非必須要素，默認(rèn)為人民幣原流水號(hào) O退貨文件中原流水號(hào)原交易日期O退貨文件中原交易日期(YYYYMMDD) 文件格式文件格式：文件格式采用CSV（CommaSeparated Variable）標(biāo)準(zhǔn)?！扒逅銓?duì)賬”文件結(jié)構(gòu)：清算對(duì)賬文件包括當(dāng)日銀行端發(fā)生的所有支付寶賬務(wù)交易數(shù)據(jù)，包括充值、支付交易。需要特別注意。清算對(duì)賬文件由匯總項(xiàng)與明細(xì)項(xiàng)兩部分組成。匯總項(xiàng)為文件第一行，其中包含要素為：。明細(xì)項(xiàng)從第二行開(kāi)始，其中包含要素為：。4 安全規(guī)范安全規(guī)范，由支付寶提供測(cè)試公、私密鑰，線上可由銀行生產(chǎn)公、私鑰。 安全配置安全配置包括：算法選擇，切換配置。 算法選擇簽名和加密算法有下面幾種方式：l 簽名密鑰配置（必選）A. 請(qǐng)求簽名算法及密鑰，如：MDDSA、RSA等B. 返回簽名算法及密鑰，如：MDDSA、RSA等l 加密密鑰配置（可選）A. 請(qǐng)求加密算法及密鑰，如：3DES、RSA等B. 返回加密算法及密鑰，如：3DES、RSA等簽名算法和密鑰是必須的，加密算法和加密密鑰為可選（只有一些特殊接口可能必須）。 切換配置當(dāng)銀行某套安全配置出現(xiàn)問(wèn)題（如：密鑰泄漏）時(shí)，銀行應(yīng)該按以下步驟切換安全配置：1) 增加一套新的安全配置，如果已經(jīng)有備用的可靠安全配置，也可以不新增；2) 修改應(yīng)用系統(tǒng)代碼，停止使用出現(xiàn)問(wèn)題的安全配置，改用新的可靠安全配置；3) 發(fā)布應(yīng)用系統(tǒng)；4) 在支付寶系統(tǒng)刪除有問(wèn)題的安全配置，指定替換該安全配置的配置。 數(shù)字簽名 簽名數(shù)據(jù)簽名數(shù)據(jù)是請(qǐng)求參數(shù)按照以下方式組裝成的字符串：1) 請(qǐng)求參數(shù)按照參數(shù)名字符升序排列，如果有重復(fù)參數(shù)名，那么重復(fù)的參數(shù)再按照參數(shù)值的字符升序排列。2) 所有參數(shù)（除了Signature）按照上面的排序用amp。連接起來(lái)，格式是：p1=v1amp。p2=v2。注意事項(xiàng)：l 沒(méi)有值的參數(shù)無(wú)需傳遞，也無(wú)需包含到待簽名數(shù)據(jù)中。l 簽名時(shí)將字符轉(zhuǎn)變成字節(jié)流時(shí)統(tǒng)一使用utf8。根據(jù)HTTP協(xié)議要求，傳遞參數(shù)的值中如果存在特殊字符（如：amp。、@等），那么該值需要做URL Encoding，這樣請(qǐng)求接受方才能接受到正確的參數(shù)值。這種情況下，做簽名時(shí)使用的應(yīng)該是原生值而不是encoding之后的值。如果參數(shù)需要進(jìn)行加密，那么，簽名是對(duì)明文進(jìn)行的，而不是加密后的密文。 簽名算法簽名算法及密鑰是在支付寶系統(tǒng)安全配置中的簽名算法及密鑰。 數(shù)據(jù)加密有些業(yè)務(wù)接口的數(shù)據(jù)比較敏感，在傳遞過(guò)程中必須進(jìn)行加密處理。這種情況下，業(yè)務(wù)接口會(huì)明確要求必須對(duì)業(yè)務(wù)數(shù)據(jù)進(jìn)行加密處理。沒(méi)有特殊聲明需要加密的接口缺省是不需要加密的。 加密內(nèi)容加密內(nèi)容為每個(gè)業(yè)務(wù)的業(yè)務(wù)要素字段。 加密算法加密算法及密鑰是在支付寶系統(tǒng)的安全配置中的加密算法及密鑰5 附錄 返回碼詳情見(jiàn)技術(shù)文檔 文件上傳規(guī)范詳情見(jiàn)技術(shù)文檔 結(jié)算標(biāo)準(zhǔn)請(qǐng)見(jiàn)《》 業(yè)務(wù)FAQ35 / 35
公司管理相關(guān)推薦
鄂ICP備17016276號(hào)-1