世聯翻譯公司完成即時到賬批量退款有密接口中文翻譯
時間:2018-11-27 08:48 來源:未知 作者:dongli 點擊:次
世聯翻譯公司完成即時到賬批量退款有密接口中文翻譯
 1 文檔說明1.1 功能描述對通過即時到賬接口付款完成的交易進行部分或全部的退還。商戶需輸入支付密碼。1.2 閱讀對象支付寶即時到賬批量退款有密接口文檔是面向具有一定的網站開發能力，了解ASP、PHP、JAVA、ASP.NET等開發語言中的一種及SQL數據庫語言的網站開發、維護和管理人員。1.3 業務術語表1-1 業務術語
2 功能演示步驟1： 商戶根據接口的要求配置批量退款請求參數，如圖2-1所示界面，并組裝成URL向支付寶系統發起請求，URL與參數配置詳見“4 請求參數說明”。圖2-1 設置批量退款接口參數 步驟2： 支付寶系統接收到商戶的URL請求之后，顯示如圖2-2所示界面。在支付密碼輸入框中輸入密碼，并點擊<確認>按鈕。 圖2-2 輸入支付密碼 步驟3： 退款申請成功后顯示如圖2-3所示界面。 圖2-3 退款申請成功界面 以上界面僅供參考，請依據商戶自身的業務邏輯或平臺管理情況，把接口嵌入到商戶系統中。 3 數據交互圖3-1 商戶系統請求/支付寶響應交互模式 (1) 構造請求數據 商戶根據支付寶提供的接口規則，通過程序生成得到簽名結果及要傳輸給支付寶的數據集合。 (2) 發送請求數據 把構造完成的數據集合，通過頁面鏈接跳轉或表單提交的方式傳遞給支付寶。 (3) 支付寶對請求數據進行處理 支付寶得到這些集合后，會先進行安全校驗等驗證，一系列驗證通過后便會處理完成這次發送過來的數據請求。 (4) 返回處理的結果數據 對于處理完成的交易，支付寶會以兩種方式把數據反饋給商戶網站。 l 返回HTML頁面的提示信息； l 支付寶服務器主動發起通知，調用商戶在請求時設定好的頁面路徑（參數notify_url，如果商戶沒設定，則不會進行該操作）。 (5) 對獲取的返回結果數據進行處理 商戶在服務器異步通知頁面（參數notify_url指定頁面文件）獲取支付寶返回的結果數據后，可以結合自身網站的業務邏輯進行數據處理。 4 請求參數說明4.1 含義請求參數是商戶在與支付寶進行數據交互時，提供給支付寶的請求數據，以便支付寶根據這些數據進一步處理。4.2 列表表4-1 請求參數說明
4.3 單筆數據集參數說明l 單筆數據集格式為：第一筆交易退款數據集#第二筆交易退款數據集#第三筆交易退款數據集…#第N筆交易退款數據集；l 交易退款數據集的格式為：原付款支付寶交易號^退款總金額^退款理由； l 不支持退分潤功能。 4.4 單筆數據集（detail_data）注意事項l detail_data中的退款筆數總和要等于參數batch_num的值；l 退款理由中不能有“^”、“|”、“$”、“#”等影響detail_data格式的特殊字符； l detail_data中退款總金額不能大于交易總金額； l 一筆交易可以多次退款，退款次數最多不能超過99次，需要遵守多次退款的總金額不超過該筆交易付款金額的原則。 4.5 樣例https://mapi.alipay.com/gateway.do?seller_email=Jier1105%40alitest.com&batch_num=1&refund_date=2011-01-12+11%3A21%3A00¬ify_url=http%3A%2F%2Fapi.test.alipay.net%2Fatinterface%2Freceive_notify.htm&sign=9b3426cac65d36f64bffbfbc6ce50549&service=refund_fastpay_by_platform_pwd&partner=2088101008267254&detail_data=2011011201037066%5E5.00%5E%D0%AD%C9%CC%CD%CB%BF%EE&sign_type=MD5&batch_no=201101120001 說明： 本樣例僅供參考，支付寶網關為https://mapi.alipay.com/gateway.do 。 5 服務器異步通知參數說明5.1 含義支付寶對商戶的請求數據處理完成后，會將處理的結果數據通過服務器主動通知的方式通知給商戶網站。這些處理結果數據就是服務器異步通知參數。5.2 列表表5-1 服務器異步通知參數說明
5.3 樣例http://www.xxx.com/alipay/notify_url.php?notify_time=2009-08-12+11%3A08%3A32¬ify_type=batch_refund_notify¬ify_id=70fec0c2730b27528665af4517c27b95&sign_type=MD5&sign=_p_w_l_h_j0b_gd_aejia7n_ko4_m%252Fu_w_jd3_nx_s_k_mxus9_hoxg_y_r_lunli_pmma29_t_q%3D%3D&batch_no=20060702001&success_num=2&result_details=2010031906272929%5E80%5ESUCCESS說明： 本樣例僅供參考，實際網關為商戶域名。 6 通知返回數據處理6.1 服務器異步通知頁面特性(1) 必須保證服務器異步通知頁面（notify_url）上無任何字符，如空格、HTML標簽、開發系統自帶拋出的異常提示信息等；(2) 支付寶是用POST方式發送通知信息，因此該頁面中獲取參數的方式，如： request.Form("out_trade_no")、$_POST['out_trade_no']； (3) 支付寶主動發起通知，該方式才會被啟用； (4) 只有在支付寶的交易管理中存在該筆交易，且發生了交易狀態的改變，支付寶才會通過該方式發起服務器通知（即時到賬中交易狀態為“等待買家付款”的狀態默認是不會發送通知的）； (5) 服務器間的交互，不像頁面跳轉同步通知可以在頁面上顯示出來，這種交互方式是不可見的； (6) 第一次交易狀態改變（即時到賬中此時交易狀態是交易完成）時，不僅頁面跳轉同步通知頁面會啟用，而且服務器異步通知頁面也會收到支付寶發來的處理結果通知； (7) 程序執行完后必須打印輸出“success”（不包含引號）。如果商戶反饋給支付寶的字符不是success這7個字符，支付寶服務器會不斷重發通知，直到超過24小時22分鐘。 一般情況下，25小時以內完成8次通知（通知的間隔頻率一般是：2m,10m,10m,1h,2h,6h,15h）； (8) 程序執行完成后，該頁面不能執行頁面跳轉。如果執行頁面跳轉，支付寶會收不到success字符，會被支付寶服務器判定為該頁面程序運行出現異常，而重發處理結果通知； (9) cookies、session等在此頁面會失效，即無法獲取這些數據； (10) 該方式的調試與運行必須在服務器上，即互聯網上能訪問； (11) 該方式的作用主要防止訂單丟失，即頁面跳轉同步通知沒有處理訂單更新，它則去處理； (12) 當商戶收到服務器異步通知并打印出success時，服務器異步通知參數notify_id才會失效。也就是說在支付寶發送同一條異步通知時（包含商戶并未成功打印出success導致支付寶重發數次通知），服務器異步通知參數notify_id是不變的。 6.2 通知觸發條件表6-1 通知觸發條件
6.3 商戶業務處理注意事項當支付寶處理完成后，支付寶會把處理結果以支付寶服務器主動通知商戶網站的形式，反饋給商戶網站。商戶可以從服務器異步通知頁面中獲得這些信息，并且在驗證通過的判斷中增加商戶的業務邏輯處理程序。當商戶有傳遞參數notify_url（服務器異步通知頁面路徑）時，商戶必須判斷商戶網站中是否已經對該次的通知結果數據做過同樣處理。如果不判斷，存在潛在的風險，商戶自行承擔因此而產生的所有損失。l 本接口只支持https請求，詳見“4.5 樣例”； l 本接口不支持退分潤； l 同一批次中不允許包含兩條交易號相同的退款明細。 說明： 更多業務處理注意事項請參見《即時到賬批量退款有密接口(refund_fastpay_by_platform_pwd)接入與使用規則》文檔。 7 簽名機制7.1 生成待簽名的字符串7.1.1 需要參與簽名的參數在請求參數列表中，除去sign、sign_type兩個參數外，其他需要使用到的參數皆是要簽名的參數。（個別接口中參數sign_type也需要參與簽名。） 在通知返回參數列表中，除去sign、sign_type兩個參數外，凡是通知返回回來的參數皆是要簽名的參數。 7.1.2 生成待簽名字符串 對于如下的參數數組： string[] parameters={ "service=refund_fastpay_by_platform_pwd", "partner=2088101008267254", "_input_charset=GBK", "return_url=http://api.test.alipay.net/atinterface/ receive_notify.htm", "batch_no=201101120001", "batch_num=1", "seller_email=Jier1105@alitest.com", "seller_user_id=2088101008267254", "detail_data=2011011201037066^5.00^協商退款", "refund_date=2011-01-12 11:21:00" }; 對數組里的每一個值從a到z的順序排序，若遇到相同首字母，則看第二個字母，以此類推。 排序完成之后，再把所有數組值以“&”字符連接起來，如： _input_charset=GBK&batch_no=201101120001&batch_num=1&detail_data=2011011201037066^5.00^協商退款&partner=2088101008267254&refund_date=2011-01-12 11:21:00&return_url=http://api.test.alipay.net/atinterface/receive_notify.htm&seller_email=Jier1105@alitest.com&seller_user_id=2088101008267254&service=refund_fastpay_by_platform_pwd 這串字符串便是待簽名字符串。 注意： l 沒有值的參數無需傳遞，也無需包含到待簽名數據中； l 簽名時將字符轉化成字節流時指定的字符集與_input_charset保持一致； l 如果傳遞了_input_charset參數，這個參數也應該包含在待簽名數據中； l 根據HTTP協議要求，傳遞參數的值中如果存在特殊字符（如：&、@等），那么該值需要做URL Encoding，這樣請求接收方才能接收到正確的參數值。這種情況下，待簽名數據應該是原生值而不是encoding之后的值。例如：調用某接口需要對請求參數email進行數字簽名，那么待簽名數據應該是email=test@msn.com，而不是email=test%40msn.com。 7.2 簽名7.2.1 MD5簽名在MD5簽名時，需要私鑰參與簽名。MD5的私鑰是以英文字母和數字組成的32位字符串。商戶可登錄到商戶服務中心（https://b.alipay.com ），安裝數字證書，在“技術服務”欄目中點擊“交易安全校驗碼”，即可查看。 l 請求時簽名 當拿到請求時的待簽名字符串后，需要把私鑰直接拼接到待簽名字符串后面，形成新的字符串，利用MD5的簽名函數對這個新的字符串進行簽名運算，從而得到32位簽名結果字符串（該字符串賦值于參數sign）。 l 通知返回時驗證簽名 當獲得到通知返回時的待簽名字符串后，同理，需要把私鑰直接拼接到待簽名字符串后面，形成新的字符串，利用MD5的簽名函數對這個新的字符串進行簽名運算，從而得到32位簽名結果字符串。此時這個新的字符串需要與支付寶通知返回參數中的參數sign的值進行驗證是否相等，來判斷簽名是否驗證通過。 7.2.2 DSA、RSA簽名 在DSA或RSA的簽名時，需要私鑰和公鑰一起參與簽名。私鑰與公鑰皆是客戶通過OPENSSL來生成得出的�？蛻舭焉沙龅墓�與支付寶技術人員配置好的支付寶公鑰做交換。因此，在簽名時，客戶要用到的是客戶的私鑰及支付寶的公鑰。 l 請求時簽名 當拿到請求時的待簽名字符串后，把待簽名字符串與客戶的私鑰一同放入DSA或RSA的簽名函數中進行簽名運算，從而得到簽名結果字符串。 l 通知返回時驗證簽名 當獲得到通知返回時的待簽名字符串后，把待簽名字符串、支付寶提供的公鑰、支付寶通知返回參數中的參數sign的值三者一同放入DSA或RSA的簽名函數中進行非對稱的簽名運算，來判斷簽名是否驗證通過。 8 如何驗證是否支付寶請求l 目的驗證此次通知信息是否是支付寶服務器發來的信息，以幫助校驗反饋回來的數據的真假性。 l 工作原理 獲取支付寶返回數據之一的通知校驗ID（notify_id），按照支付寶要求的格式拼接成要請求的鏈接，如： https://mapi.alipay.com/gateway.do?service=notify_verify&partner=2088002396712354¬ify_id=RqPnCoPT3K9%252Fvwbh3I%252BFioE227%252BPfNMl8jwyZqMIiXQWxhOCmQ5MQO%252FWd93rvCB%252BaiGg 通過訪問這個請求鏈接，利用編程方法來模擬http請求與支付寶服務器進行交互，獲得支付寶服務器上處理的結果。 如果獲得的信息是true，則校驗成功；如果獲得的信息是其他，則校驗失敗。 9 建議與意見如果您在閱讀技術文檔時有任何建議和意見，請點擊下面的鏈接跟帖回復，我們將根據您的反饋完善文檔內容。http://club.alipay.com/read.php?tid=8684674&fid=703 10 附錄10.1 即時到賬批量退款業務錯誤碼表10-1 即時到賬批量退款業務錯誤碼
10.2 系統錯誤碼注意：當出現系統錯誤提示時，請聯系支付寶技術支持協助處理。 表10-2 系統錯誤碼
世聯翻譯-讓世界自由溝通！專業的全球語言翻譯供應商，上海翻譯公司專業品牌。絲路沿線56種語言一站式翻譯與技術解決方案，專業英語翻譯、日語翻譯等文檔翻譯、同傳口譯、視頻翻譯、出國外派服務，加速您的全球交付。 世聯翻譯公司在北京、上海、深圳等國際交往城市設有翻譯基地，業務覆蓋全國城市。每天有近百萬字節的信息和貿易通過世聯走向全球！積累了大量政商用戶數據，翻譯人才庫數據，多語種語料庫大數據。世聯品牌和服務品質已得到政務防務和國際組織、跨國公司和大中型企業等近萬用戶的認可。 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
