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