- 翻譯公司資訊
-
世聯(lián)翻譯公司完成即時(shí)到賬退款接口文檔說(shuō)明中文翻譯
發(fā)布時(shí)間：2018-11-13 09:13 點(diǎn)擊：
世聯(lián)翻譯公司完成即時(shí)到賬退款接口文檔說(shuō)明中文翻譯
1 文檔說(shuō)明1.1 文檔說(shuō)明本文檔是《即時(shí)到賬批量退款有密接口(refund_fastpay_by_platform_pwd)》附錄文檔，它詳細解釋了在技術(shù)接入與使用過(guò)程中需要注意的地方，以幫助商戶(hù)避免風(fēng)險產(chǎn)生。閱讀后如有疑問(wèn)，請聯(lián)系支付寶相關(guān)技術(shù)支持。1.2 業(yè)務(wù)術(shù)語(yǔ)表1-1 業(yè)務(wù)術(shù)語(yǔ)術(shù)語(yǔ) 解釋請求 通過(guò)HTTP協(xié)議把需要傳輸的數據發(fā)送給接收方的過(guò)程。返回 支付寶根據得到的數據處理完成后，支付寶將處理完成的結果信息反饋給商戶(hù)網(wǎng)站。敏感詞 帶有敏感政治傾向、暴力傾向、不健康色彩或不文明的詞。特殊字符 在detail_data的格式中用來(lái)作分割符，特殊字符包括：“^”、“|”、“$”、“#”。2 責任歸屬文檔中所涉及到的規則都是根據在接入與使用支付寶接口的過(guò)程中出現的一些主要風(fēng)險而做的防范措施，請商戶(hù)予以關(guān)注。請在接入及使用支付寶接口的過(guò)程中，嚴格依照支付寶提供的接口技術(shù)文檔（即時(shí)到賬批量退款有密接口(refund_fastpay_by_platform_pwd).pdf）、代碼示例、本文檔（即時(shí)到賬批量退款有密接口(refund_fastpay_by_platform_pwd)接入與使用規則）等接口資料，否則由此導致的風(fēng)險以及資金損失或者擴大情形需商戶(hù)自行承擔。3 技術(shù)接入規則表3-1 技術(shù)接入規則類(lèi)型 細則 原因賬號 配置的合作者身份ID與安全校驗碼key必須保證與簽約信息匹配 防止接口無(wú)法正常使用或出現資金損失必須保護合作者身份ID與安全校驗碼key的隱私性 防止簽約的賬號信息被盜用，導致資金受損、被他人惡意利用等。安全 支付寶的通知IP是121.0.26.1與121.0.26.2。該IP地址不是商戶(hù)訪(fǎng)問(wèn)支付寶的地址，而是支付寶發(fā)送通知給商戶(hù)的出口地址。 如果商戶(hù)網(wǎng)站設置了IP白名單（即IP過(guò)濾），需要把支付寶的通知IP地址加入白名單中商戶(hù)必須以DNS解析的方式訪(fǎng)問(wèn)支付寶接口，不要設置DNS cache，不要綁定支付寶IP。如果為了商戶(hù)自身安全必須綁定支付寶IP時(shí)，必須向支付寶的技術(shù)支持人員備案。 支付寶IP地址一旦變更，會(huì )導致商戶(hù)無(wú)法請求或訪(fǎng)問(wèn)支付寶，致使商戶(hù)業(yè)務(wù)直接不可用。簽名 請求的所有參數，需要根據參數名=參數值的格式，按首字符字典順序（ascii值大�。┡判�，若遇到相同首字符，則判斷第二個(gè)字符，以此類(lèi)推，待簽名字符串需要以“參數名1=參數值1&參數名2=參數值2&….&參數名N=參數值N”的規則進(jìn)行拼接。 避免接口無(wú)法正常使用在對請求的參數做簽名時(shí)，這些參數必須來(lái)源于請求參數列表，并且除去列表中的參數sign、sign_type。 避免接口無(wú)法正常使用在對請求的參數做簽名時(shí)，對于請求參數列表中那些可空的參數，如果選擇使用它們，那么這些參數的參數值必須不能為空或空值。 避免接口無(wú)法正常使用簽名時(shí)將字符轉化成字節流時(shí)指定的字符集與_input_charset保持一致；如果傳遞了_input_charset參數，這個(gè)參數也應該包含在待簽名數據中。 避免接口報錯ILLEGAL_SIGN待簽名數據應該是參數原始值而不是url encoding之后的值，例如：調用某接口需要對請求參數email進(jìn)行數字簽名，那么待簽名數據應該是email=test@msn.com，而不是email=test%40msn.com。 避免接口報錯ILLEGAL_SIGN參數配置 在請求參數列表中，不可空的參數必須配置。 避免接口無(wú)法正常使用在請求參數列表中，可空的但需要多選一的多個(gè)參數中，必須配置至少一個(gè)。 避免接口無(wú)法正常使用必須按照請求參數列表中各參數的格式要求配置 避免接口無(wú)法正常使用必須設置請求參數_input_charset（編碼格式），即該參數不能為空，并讓該參數加入簽名運算。 避免接口無(wú)法正常使用退款理由中不能包含“^”、“|”、“$”、“#”等影響detail_data格式的特殊字符。 避免接口無(wú)法正常使用集成該接口時(shí)，退款批次號batch_no的格式必須是提交的當天日期+隨機數。 業(yè)務(wù)規則要求無(wú)退分潤數據集格式 不支持退分潤功能接口構造 必須使用支付寶的網(wǎng)關(guān)發(fā)送請求信息給支付寶，請求網(wǎng)關(guān)：https://mapi.alipay.com/gateway.do。避免被釣魚(yú)網(wǎng)站利用發(fā)送給支付寶的請求，請求參數不僅包含參與簽名的參數，還包含參數sign、sign_type。 避免接口無(wú)法正常使用發(fā)送給支付寶的請求，如果使用form表單傳輸，需要按照以下要求編寫(xiě)： action的值必須為“https://mapi.alipay.com/gateway.do?_input_charset=該值”，如：https://mapi.alipay.com/gateway.do?_input_charset=utf-8。 不允許寫(xiě)成完整的請求鏈接地址，即禁止https://mapi.alipay.com/gateway.do?后帶有所有要請求給支付寶的請求參數數據； <form>與</form>之間需包含所有要請求給支付寶的參數，且每個(gè)參數的格式為<input type="hidden" name="參數名" value="參數值" />； 在眾多請求參數中，請求參數_input_charset（編碼格式）必須存在于form表單中，即form表單中必須含有<input type="hidden" name="_input_charset" value="參數值">； <form>與</form>之間包含的數據只允許是要請求給支付寶的參數，禁止出現商戶(hù)自行命名，不在接口技術(shù)文檔請求參數列表中的其他數據； form表單的method屬性，可自行選擇get、post兩種。 避免請求支付寶時(shí)報錯，錯誤碼為ILLEGAL_SIGN； 在win7系統下，如果瀏覽器是IE8以上，有可能出現發(fā)送請求鏈接時(shí)會(huì )無(wú)法跳轉到支付寶，當前頁(yè)面為空白頁(yè)的情況。數據傳輸 必須使用https協(xié)議，支持get或post方式提交。 避免接口無(wú)法正常使用通知返回驗證 如果有設置通知路徑及觸發(fā)條件，則必須使用獲取到的參數notify_id再次請求支付寶，獲取是否是支付寶發(fā)送的驗證結果。該請求鏈接是：https://mapi.alipay.com/gateway.do?partner=合作者身份ID¬ify_id=通知ID的值 驗證是否是支付寶發(fā)來(lái)的請求在對通知的參數做簽名時(shí)，這些參數必須來(lái)源于支付寶通知回來(lái)的參數，并且除去列表中的參數sign、sign_type，根據參數名=參數值的格式，按首字符字典順序（ascii值大�。┡判�，若遇到相同首字符，則判斷第二個(gè)字符，以此類(lèi)推，待簽名字符串需要以“參數名1=參數值1&參數名2=參數值2&….&參數名N=參數值N”的規則進(jìn)行拼接，得到的簽名結果與獲取到的參數sign值做比較。 驗證返回的簽名返回數據處理 在返回參數中，“退款成功總數（success_num）”參數值說(shuō)明一個(gè)退款批次中退款成功的總筆數。 避免商戶(hù)獲取狀態(tài)失敗導致業(yè)務(wù)線(xiàn)的退款全部失敗退款成功后，除了本接口的異步通知結果返回，還有即時(shí)到賬接口也會(huì )被觸發(fā)發(fā)送交易退款狀態(tài)通知給商戶(hù)。 商戶(hù)要做好業(yè)務(wù)邏輯判斷，以免造成多退款的資損。本接口直接返回的XML信息（T/F）僅代表提交成功與否，不代表退款成功或者失敗，商戶(hù)必須根據退款異步通知中的結果集來(lái)判斷是否退款成功。 避免由于商戶(hù)余額不足等問(wèn)題導致接口提交退款失敗使用戶(hù)投訴支付寶主動(dòng)發(fā)送通知，當商戶(hù)接收到通知數據后必須給支付寶返回“success”字符串，不允許返回其他多余字符。 如果商戶(hù)返回給支付寶的信息不是“success”，支付寶最多重復發(fā)送8次通知。必須保證設置的通知路徑互聯(lián)網(wǎng)上能訪(fǎng)問(wèn)得到，且訪(fǎng)問(wèn)順暢。 避免接收不到支付寶發(fā)送的通知必須對返回的數據進(jìn)行處理 以便商戶(hù)能夠了解接口的使用情況，以及進(jìn)行商戶(hù)的后續業(yè)務(wù)操作。必須判斷退款操作以后的業(yè)務(wù)邏輯處理程序是否有重復執行 防止出現商戶(hù)的業(yè)務(wù)操作被重復執行，導致出現資金損失，如重復充值、重復付款等。建議每一次退款操作需以日志形式記錄到商戶(hù)網(wǎng)站的日志操作數據庫中 用來(lái)在必要時(shí)檢查或跟蹤業(yè)務(wù)處理情況接入環(huán)境 不能把接口嵌入iframe框架中 避免接口無(wú)法正常使用錯誤碼處理 遇到特殊錯誤碼（如：UNKNOWN_EXCEPTION、GENERIC_FAILURE、SYSTEM_ERROR），須暫停后續操作，或者聯(lián)系支付寶技術(shù)支持協(xié)助處理。HTML方式返回或異步通知方式返回。 一般這種情況有可能請求已經(jīng)提交到支付寶，支付寶系統失去響應但有可能由恢復機制自動(dòng)回復并提交請求。出現“REFUND_DATE_ERROR”表示退款時(shí)間錯誤，請修改退款時(shí)間重新提交請求。HTML方式返回。 出現這種情況可能原因： 退款時(shí)間為空或格式不符合yyyy-MM-dd HH:mm:ss； 退款日期與退款批次號中的日期不一致。出現“TRADE_STATUS_ERROR”表示在該交易狀態(tài)下不允許退款。HTML方式返回。 可能原因：因交易一方賬號被鎖定，導致交易處于掛起狀態(tài)而不能退款。出現“REFUND_FAIL”表示退款失敗，請聯(lián)系支付寶技術(shù)支持協(xié)助處理。異步通知方式返回。 該結果碼只會(huì )出現在做意外數據恢復時(shí)，找不到結果碼的情況。出現“RESULT_AMOUNT_NOT_VALID”表示退款金額不合理，請重新檢查退款金額。異步通知方式返回。 可能原因：一般是交易金額大于退款金額，如退款的票面價(jià)、機建費、燃油費、航意險大于交易時(shí)的相關(guān)金額。出現“REFUND_TRADE_FEE_ERROR”表示交易退款金額與付款金額不一致，請更新交易退款金額。異步通知方式返回。 出現原因是退款金額與付款金額不一致出現“BATCH_REFUND_LOCK_ERROR”表示同一時(shí)間不允許進(jìn)行多筆并發(fā)退款。異步通知方式返回。 同一時(shí)間不允許進(jìn)行多筆并發(fā)退款遇到如下錯誤碼時(shí)，系統會(huì )啟動(dòng)重試機制： TRADE_PAYMENT_ERROR TRADE_PROCESS_ERROR QUERY_PARTICIPANT_ERROR商戶(hù)無(wú)需處理。 支付寶系統內部錯誤，可以由支付寶內部自行解決自主編寫(xiě)接口代碼規則 如果不使用支付寶提供的代碼示例來(lái)集成接口，那么必須根據技術(shù)文檔中簽名機制和通知返回數據處理章節及本文檔的技術(shù)接入規則、接口使用規則、測試流程規則，來(lái)編寫(xiě)符合商戶(hù)網(wǎng)站項目的接口代碼。 避免接口無(wú)法正常使用4 接口使用規則表4-1 接口使用規則類(lèi)型規范點(diǎn)原因網(wǎng)絡(luò ) 確保網(wǎng)絡(luò )順暢 防止接口調用失敗業(yè)務(wù)操作規則 接口支持重復調用，但必須確保每個(gè)合作伙伴每個(gè)退款批次號（batch_no）的唯一性。 防止重復退款同一批明細里（detail_data）不允許包含兩條交易號相同的退款明細 防止重復退款必須保證要退款的賬號余額充足 避免退款不成功要退款的交易號必須存在且已經(jīng)是付款成功狀態(tài)，即交易狀態(tài)（TRADE_STATUS）是TRADE_SUCCESS的狀態(tài)。 避免退款不成功收款賬號不是簽約賬號，即參數seller_email填寫(xiě)的支付寶賬號對應的合作者身份ID不是參數partner對應的合作者身份ID，該seller_email填寫(xiě)的支付寶賬號必須與平臺或者退款接口使用商戶(hù)簽約支付圈接口。 否則退款時(shí)會(huì )報沒(méi)有簽約的錯誤，即“PARTNER_NOT_SIGN_PROTOCOL”。如果請求支付寶以后IS_SUCCESS返回T，那么當該批次中有一個(gè)或多個(gè)交易退款失敗，此時(shí)不影響整個(gè)批次中其他交易的退款。 如果請求支付寶以后IS_SUCCESS返回為F，那么該筆批次的所有交易退款都失��； 如果請求支付寶以后IS_SUCCESS返回為T(mén)，該筆批次中的各個(gè)交易彼此獨立，所以失敗的交易退款不會(huì )影響成功的交易退款。如果接口中設置了notify_url，當請求支付寶以后IS_SUCCESS返回為F時(shí)，支付寶系統不會(huì )發(fā)送服務(wù)器異步通知。 對請求的校驗未通過(guò)余額支付功能關(guān)閉的情況下，接口退款不受影響。 保證商戶(hù)順利完成交易退款該接口支持單筆和批量退款，批量退款最多一次支持1000筆，50筆是最高效的退款筆數。數據請求以表單POST方式發(fā)送到支付寶。 無(wú)法傳遞大量數據一筆交易可以多次退款，只需要遵守多次退款的總金額不超過(guò)該筆交易付款金額的原則。 支持多次退款一筆交易的退款次數上限為99次 超過(guò)該次數則支付寶系統不會(huì )處理該筆交易的退款，如果接口中設置了notify_url，那么支付寶系統也不會(huì )發(fā)送服務(wù)器異步通知。需要對退款成功后的異步通知返回結果做所有返回參數的解析分類(lèi)，判斷交易狀態(tài)即可。 防止未來(lái)業(yè)務(wù)變更，有更好的兼容性。操作退款時(shí)需要安裝數字證書(shū)或支付盾等其他安全產(chǎn)品。 有密退款時(shí)需要輸入支付密碼單筆數據集規則 退款筆數總和要等于參數batch_num的值 數據一致，防止發(fā)生退款金額錯誤。退款資金流向 客戶(hù)銀行卡掛失或者注銷(xiāo)將無(wú)法退回到客戶(hù)賬戶(hù)中。需要商戶(hù)向客戶(hù)收集新的銀行卡號并且提供聲明對新的銀行卡號正確性負責，委托支付寶退款。 退回到卡的情況：信用卡、信用卡卡通、Q賬號、支付寶中間賬號（例如：0571-88158090@alipay.com）支付的訂單；其他的實(shí)時(shí)到賬退到支付寶余額賬戶(hù)。接口異常 異步處理如果響應時(shí)間過(guò)長(cháng)直接導致退款返回失敗，或者退款通知超過(guò)24小時(shí)未發(fā)出，則可以人工進(jìn)行重新提交請求。 可能是支付寶的消息積壓導致異步調度任務(wù)失敗5 測試流程規則表5-1 測試流程規則步驟調試內容備注Windows環(huán)境（linux環(huán)境）服務(wù)器配置要求：推薦配置Java 1.6以上運行環(huán)境，符合servlet2.4規范的WEB容器。第一步：在本機單獨對這個(gè)接口進(jìn)行調試。 根據接口要求配置批量退款請求參數，發(fā)送請求數據 返回批量退款處理結果數據僅僅把接口配置好，不要放在商戶(hù)的網(wǎng)站項目中。第二步：在服務(wù)器上單獨對這個(gè)而接口進(jìn)行調試 根據接口要求配置批量退款請求參數，發(fā)送請求數據 返回批量退款處理結果數據本機調試沒(méi)有問(wèn)題后，再放入服務(wù)器中調試。第三步：接口融合到網(wǎng)站項目中 根據接口要求配置批量退款請求參數，發(fā)送請求數據 返回批量退款處理結果數據 對獲取的返回結果數據進(jìn)行處理把調試好的接口與商戶(hù)網(wǎng)站項目的業(yè)務(wù)流程進(jìn)行銜接和融合。第四步：在本機對融合后的網(wǎng)站項目進(jìn)行調試 整個(gè)業(yè)務(wù)操作流程 根據接口要求配置批量退款請求參數，發(fā)送請求數據 返回批量退款處理結果數據 對獲取的返回結果數據進(jìn)行處理 業(yè)務(wù)后續的執行在本機調試銜接到網(wǎng)站項目后的接口。第五步：在服務(wù)器對融合后的網(wǎng)站項目進(jìn)行調試 整個(gè)業(yè)務(wù)操作流程 根據接口要求配置批量退款請求參數，發(fā)送請求數據 返回批量退款處理結果數據 對獲取的返回結果數據進(jìn)行處理 業(yè)務(wù)后續的執行本機調試沒(méi)有問(wèn)題后，再放入服務(wù)器中調試。Unitrans世聯(lián)翻譯公司在您身邊,離您近的翻譯公司,心貼心的專(zhuān)業(yè)服務(wù),專(zhuān)業(yè)的全球語(yǔ)言翻譯與信息解決方案供應商,專(zhuān)業(yè)翻譯機構品牌。無(wú)論在本地,國內還是海外,我們的專(zhuān)業(yè)、星級體貼服務(wù)，為您的事業(yè)加速！世聯(lián)翻譯公司在北京、上海、深圳等國際交往城市設有翻譯基地，業(yè)務(wù)覆蓋全國城市。每天有近百萬(wàn)字節的信息和貿易通過(guò)世聯(lián)走向全球！積累了大量政商用戶(hù)數據，翻譯人才庫數據，多語(yǔ)種語(yǔ)料庫大數據。世聯(lián)品牌和服務(wù)品質(zhì)已得到政務(wù)防務(wù)和國際組織、跨國公司和大中型企業(yè)等近萬(wàn)用戶(hù)的認可。 專(zhuān)業(yè)翻譯公司,北京翻譯公司,上海翻譯公司,英文翻譯,日文翻譯,韓語(yǔ)翻譯,翻譯公司排行榜,翻譯公司收費價(jià)格表,翻譯公司收費標準,翻譯公司北京,翻譯公司上海。
