- 行業(yè)新聞
-
上海翻譯公司完成電子系統(tǒng)-交易口中文翻譯
發(fā)布時(shí)間：2018-11-13 09:00 點(diǎn)擊：
上海翻譯公司完成電子系統(tǒng)-交易口中文翻譯
1 文檔說(shuō)明1.1 文檔說(shuō)明本文檔是《即時(shí)到賬交易接口、純網(wǎng)關(guān)接口、大額信用卡接口、快捷支付前置接口、快捷支付網(wǎng)關(guān)接口、信用卡分期支付接口(create_direct_pay_by_user)》附錄文檔，它詳細(xì)解釋了在技術(shù)接入與使用過(guò)程中需要注意的地方，以幫助商戶避免風(fēng)險(xiǎn)產(chǎn)生。閱讀后如有疑問(wèn)，請(qǐng)聯(lián)系支付寶相關(guān)技術(shù)支持。1.2 業(yè)務(wù)術(shù)語(yǔ)表1-1 業(yè)務(wù)術(shù)語(yǔ)術(shù)語(yǔ) 解釋CTU 支付寶風(fēng)險(xiǎn)稽查系統(tǒng)。定向支付 用戶事先指定支付金額的收款方，對(duì)應(yīng)的交易只能將金額轉(zhuǎn)入指定的收款方賬戶中。返回 支付寶根據(jù)得到的數(shù)據(jù)處理完成后，支付寶將處理完成的結(jié)果信息反饋給商戶網(wǎng)站。防釣魚 “網(wǎng)絡(luò)釣魚”攻擊利用欺騙性的電子郵件和偽造的Web站點(diǎn)來(lái)進(jìn)行詐騙活動(dòng)，受騙者往往會(huì)泄露自己的財(cái)務(wù)數(shù)據(jù)，如信用卡號(hào)、賬戶用戶名、口令和社保編號(hào)等內(nèi)容，造成損失。防釣魚用來(lái)防止以上情況的發(fā)生。分潤(rùn) 分潤(rùn)是指將交易金額中的一部分轉(zhuǎn)賬給其它賬戶。快捷登錄 快捷登錄產(chǎn)品主要有以下功能： 用戶在商戶的網(wǎng)站上，可以使用支付寶快捷登錄，并共享支付寶的收貨地址等物流信息給商戶； 如果用戶在商戶網(wǎng)站上使用了支付寶快捷登錄，那么在支付寶支付時(shí)，不需要再次在支付寶登錄。敏感詞 帶有敏感政治傾向、暴力傾向、不健康色彩或不文明的詞。請(qǐng)求 通過(guò)HTTP協(xié)議把需要傳輸?shù)臄?shù)據(jù)發(fā)送給接收方的過(guò)程。特殊字符 用做url轉(zhuǎn)義字符，或在接口參數(shù)中用作分割符的特殊字符，包括：#、%、&、+、^、|。2 責(zé)任歸屬文檔中所涉及到的規(guī)則都是根據(jù)在接入與使用支付寶接口的過(guò)程中出現(xiàn)的一些主要風(fēng)險(xiǎn)而做的防范措施，請(qǐng)商戶予以關(guān)注。請(qǐng)?jiān)诮尤爰笆褂弥Ц秾毥涌诘倪^(guò)程中，嚴(yán)格依照支付寶提供的接口技術(shù)文檔（即時(shí)到賬交易接口、純網(wǎng)關(guān)接口、大額信用卡接口、快捷支付前置接口、快捷支付網(wǎng)關(guān)接口、信用卡分期支付接口(create_direct_pay_by_user).pdf）、代碼示例、本文檔（即時(shí)到賬交易接口、純網(wǎng)關(guān)接口、大額信用卡接口、快捷支付前置接口、快捷支付網(wǎng)關(guān)接口、信用卡分期支付接口(create_direct_pay_by_user)接入與使用規(guī)則）等接口資料，否則由此導(dǎo)致的風(fēng)險(xiǎn)以及資金損失或者擴(kuò)大情形需商戶自行承擔(dān)。3 技術(shù)接入規(guī)則表3-1 技術(shù)接入規(guī)則類型細(xì)則原因賬號(hào) 配置的合作者身份ID與安全校驗(yàn)碼key必須保證與簽約信息匹配 防止接口無(wú)法正常使用或出現(xiàn)資金損失必須保護(hù)合作者身份ID與安全校驗(yàn)碼key的隱私性 防止簽約的賬號(hào)信息被盜用，導(dǎo)致資金受損、被他人惡意利用等。測(cè)試完畢后，要把測(cè)試賬號(hào)立刻更換成簽約賬號(hào)。 使用測(cè)試賬號(hào)時(shí)，手續(xù)費(fèi)按照3%扣除。安全 該接口必須使用https請(qǐng)求 避免請(qǐng)求參數(shù)暴露支付寶的通知IP是121.0.26.1與121.0.26.2。該IP地址不是商戶訪問(wèn)支付寶的地址，而是支付寶發(fā)送通知給商戶的出口地址。 如果商戶網(wǎng)站設(shè)置了IP白名單（即IP過(guò)濾），需要把支付寶的通知IP地址加入白名單中。商戶必須以DNS解析的方式訪問(wèn)支付寶接口，不要設(shè)置DNS cache，不要綁定支付寶IP。如果為了商戶自身安全必須綁定支付寶IP時(shí)，必須向支付寶的技術(shù)支持人員備案。 支付寶IP地址一旦變更，會(huì)導(dǎo)致商戶無(wú)法請(qǐng)求或訪問(wèn)支付寶，致使商戶業(yè)務(wù)直接不可用。簽名 請(qǐng)求的所有參數(shù)，需要根據(jù)參數(shù)名=參數(shù)值的格式，按首字符字典順序（ascii值大�。┡判�，若遇到相同首字符，則判斷第二個(gè)字符，以此類推，待簽名字符串需要以“參數(shù)名1=參數(shù)值1&參數(shù)名2=參數(shù)值2&….&參數(shù)名N=參數(shù)值N”的規(guī)則進(jìn)行拼接。 避免接口無(wú)法正常使用在對(duì)請(qǐng)求的參數(shù)做簽名時(shí)，這些參數(shù)必須來(lái)源于請(qǐng)求參數(shù)列表，并且除去列表中的參數(shù)sign、sign_type。 避免接口無(wú)法正常使用在對(duì)請(qǐng)求的參數(shù)做簽名時(shí)，對(duì)于請(qǐng)求參數(shù)列表中那些可空的參數(shù)，如果選擇使用它們，那么這些參數(shù)的參數(shù)值必須不能為空或空值。 避免接口無(wú)法正常使用簽名時(shí)將字符轉(zhuǎn)化成字節(jié)流時(shí)指定的字符集與_input_charset保持一致；如果傳遞了_input_charset參數(shù)，這個(gè)參數(shù)也應(yīng)該包含在待簽名數(shù)據(jù)中。 避免接口無(wú)法正常使用待簽名數(shù)據(jù)應(yīng)該是參數(shù)原始值而不是url encoding之后的值，例如：調(diào)用某接口需要對(duì)請(qǐng)求參數(shù)email進(jìn)行數(shù)字簽名，那么待簽名數(shù)據(jù)應(yīng)該是[email protected]，而不是email=test%40msn.com。 避免接口無(wú)法正常使用參數(shù)配置 在請(qǐng)求參數(shù)列表中，不可空的參數(shù)必須配置。 避免接口無(wú)法正常使用在請(qǐng)求參數(shù)列表中，可空的但需要多選一的多個(gè)參數(shù)中，必須配置至少一個(gè)。 避免接口無(wú)法正常使用必須按照請(qǐng)求參數(shù)列表中各參數(shù)的格式要求配置 避免接口無(wú)法正常使用必須設(shè)置請(qǐng)求參數(shù)_input_charset（編碼格式），即該參數(shù)不能為空，并讓該參數(shù)加入簽名運(yùn)算。 避免接口無(wú)法正常使用當(dāng)設(shè)置paymethod（默認(rèn)支付方式）為directPay（余額支付）時(shí)，請(qǐng)求參數(shù)defaultbank（默認(rèn)網(wǎng)銀）不要設(shè)置或不要傳遞。 避免該交易按其他支付方式執(zhí)行只有開(kāi)通了自定義超時(shí)功能，才能使用請(qǐng)求參數(shù)it_b_pay（超時(shí)時(shí)間）。 避免接口報(bào)錯(cuò)誤碼SELF_TIMEOUT_NOT_SUPPORT只有開(kāi)通了防釣魚功能且開(kāi)通了防釣魚時(shí)間戳，才能使用請(qǐng)求參數(shù)anti_phishing_key（防釣魚時(shí)間戳）。 避免接口無(wú)法正常使用只有開(kāi)通了防釣魚功能且開(kāi)通了IP地址檢查，才能使用請(qǐng)求參數(shù)exter_invoke_ip（客戶端IP）。 避免接口無(wú)法正常使用只有開(kāi)通了網(wǎng)銀支付時(shí)是否做CTU校驗(yàn)，才能使用請(qǐng)求參數(shù)need_ctu_check（網(wǎng)銀支付時(shí)是否做CTU校驗(yàn)）。 避免接口無(wú)法正常使用只有開(kāi)通了快捷登錄，才能使用請(qǐng)求參數(shù)token（授權(quán)令牌碼），且必須設(shè)置token。 減少用戶付款時(shí)重復(fù)登錄支付寶請(qǐng)求參數(shù)subjet、body的值，以及extend_param、item_orders_info、royalty_parameters的備注表述信息中不要使用敏感詞。 避免接口無(wú)法正常使用請(qǐng)求參數(shù)notify_url的設(shè)置必須是互聯(lián)網(wǎng)上能訪問(wèn)到且訪問(wèn)正常的路徑地址 避免商戶網(wǎng)站無(wú)法收到支付寶的主動(dòng)通知請(qǐng)求參數(shù)return_url的設(shè)置不能是http://localhost/這類地址，必須是服務(wù)器ip地址或者域名方式。（例如:127.0.0.1） 避免付款成功后，當(dāng)前頁(yè)面停留在支付寶交易完成提醒頁(yè)面，而不做任何跳轉(zhuǎn)請(qǐng)求參數(shù)return_url的設(shè)置不能是含有“!”這類特殊字符的地址 避免付款成功后，當(dāng)前頁(yè)面停留在支付寶交易完成提醒頁(yè)面，而不做任何跳轉(zhuǎn)royalty_parameters（分潤(rùn)賬號(hào)集）、extend_param（公用業(yè)務(wù)擴(kuò)展參數(shù)）參數(shù)中的備注描述信息中不能出現(xiàn)用作字段分割符的“^”、“|”特殊字符。 避免出現(xiàn)數(shù)據(jù)格式錯(cuò)誤，導(dǎo)致分潤(rùn)失敗。當(dāng)使用了分潤(rùn)功能時(shí)，在設(shè)置請(qǐng)求參數(shù)royalty_parameters（分潤(rùn)賬號(hào)集）的值時(shí)，分潤(rùn)的總金額不能超過(guò)付款總金額減去支付寶手續(xù)費(fèi)所余下的金額。 避免分潤(rùn)失敗，而導(dǎo)致接口無(wú)法正常使用。當(dāng)使用了分潤(rùn)功能時(shí)，在設(shè)置請(qǐng)求參數(shù)royalty_parameters（分潤(rùn)賬號(hào)集）的值時(shí)，分潤(rùn)的收款賬戶必須是有效的收款賬號(hào)。 避免分潤(rùn)失敗，而導(dǎo)致接口無(wú)法正常使用。seller_id（賣家支付寶用戶號(hào)）、seller_account_name（賣家別名支付寶賬號(hào)）、seller_email（賣家支付寶賬號(hào)）不能全部為空，至少有一項(xiàng)不為空。在都不為空的情況下，優(yōu)先級(jí)順序?yàn)椋簊eller_id >seller_account_name >seller_email 數(shù)據(jù)完整一致，避免出現(xiàn)賣家信息錯(cuò)誤。如果設(shè)置了買家支付寶賬號(hào)（如buyer_email等），那么買家支付寶賬號(hào)不能與賣家支付寶賬號(hào)相同，即：buyer_emai與seller_email不能相同、buyer_id與seller_id不能相同、buyer_account與seller_account不能相同）。 避免報(bào)錯(cuò)，如錯(cuò)誤碼：BUYER_SELLER_EQUAL。price（商品單價(jià)）、quantity（購(gòu)買數(shù)量）會(huì)替換total_fee（交易金額）。即total_fee不能與price、quantity同時(shí)存在；存在price、quantity，就不能存在total_fee。 防止出現(xiàn)支付金額錯(cuò)誤在給請(qǐng)求參數(shù)defaultbank、paymethod賦值時(shí)，需注意區(qū)分大小寫。 否則會(huì)引起銀行直連調(diào)用失敗只有開(kāi)通了純網(wǎng)關(guān)（即網(wǎng)銀直連），且paymethod賦值為bankPay時(shí)，才有純網(wǎng)關(guān)的效果。如果沒(méi)有開(kāi)通，則paymethod禁止賦值為bankPay。 如果沒(méi)有開(kāi)通該功能，而又設(shè)置了paymethod為bankPay，那么會(huì)出現(xiàn)以下兩種情況： 從來(lái)沒(méi)有開(kāi)通過(guò)，報(bào)沒(méi)有開(kāi)通該產(chǎn)品的提示錯(cuò)誤； 曾經(jīng)有開(kāi)通過(guò)，交易費(fèi)率按照純網(wǎng)關(guān)的測(cè)試費(fèi)率3%收取。只有開(kāi)通了大額信用卡功能，且 paymethod=CREDITCARD credit_card_pay=Y credit_card_default_display=Y如此設(shè)置以上3個(gè)參數(shù)值時(shí)，才有大額信用卡的效果。 如果沒(méi)開(kāi)通該功能，即使paymethod賦值為CREDITCARD也無(wú)效，甚至?xí)䦂?bào)沒(méi)有開(kāi)通該產(chǎn)品的提示錯(cuò)誤。只有開(kāi)通了信用支付，且paymethod賦值為creditPay時(shí)，才有信用支付的效果。 如果沒(méi)開(kāi)通該功能，即使paymethod賦值為creditPay也無(wú)效，甚至?xí)䦂?bào)沒(méi)有開(kāi)通該產(chǎn)品的提示錯(cuò)誤。只有開(kāi)通了信用卡分期，且paymethod賦值為CCIP時(shí)，才有信用卡分期的效果。 如果沒(méi)開(kāi)通該功能，即使paymethod賦值為CCIP也無(wú)效，甚至?xí)䦂?bào)沒(méi)有開(kāi)通該產(chǎn)品的提示錯(cuò)誤。只有開(kāi)通了快捷支付前置，且paymethod賦值為motoPay時(shí)，才有快捷支付前置的效果。 如果沒(méi)開(kāi)通該功能，即使paymethod賦值為motoPay也無(wú)效，甚至?xí)䦂?bào)沒(méi)有開(kāi)通該產(chǎn)品的提示錯(cuò)誤。只有開(kāi)通了快捷支付網(wǎng)關(guān)，且paymethod賦值為以下3個(gè)值之一： expressGatewayDebit（快捷支付網(wǎng)關(guān)借記卡單通道） expressGatewayCredit（快捷支付網(wǎng)關(guān)信用卡單通道） expressGateway（快捷支付網(wǎng)關(guān)雙通道）且default_login賦值為Y，以上2個(gè)參數(shù)必須都設(shè)置，才有快捷支付網(wǎng)關(guān)的效果。 如果沒(méi)開(kāi)通該功能，即使paymethod賦值為對(duì)應(yīng)的值也無(wú)效，甚至?xí)䦂?bào)沒(méi)有開(kāi)通該產(chǎn)品的提示錯(cuò)誤。 如果是etao接入的商戶，那么必須設(shè)置請(qǐng)求參數(shù)error_notify_url和item_orders_info； 如果不是etao接入商戶，item_orders_info不要設(shè)置。 error_notify_url是使用接口時(shí)請(qǐng)求支付寶報(bào)錯(cuò)時(shí)商戶能收到報(bào)錯(cuò)信息的地址； item_orders_info是買家通過(guò) etao購(gòu)買的商品的詳細(xì)清單。該數(shù)據(jù)能同步到etao的訂單列表中。必須使用支付寶的網(wǎng)關(guān)發(fā)送請(qǐng)求信息給支付寶，請(qǐng)求網(wǎng)關(guān)：https://mapi.alipay.com/gateway.do。避免被釣魚網(wǎng)站利用發(fā)送給支付寶的請(qǐng)求，請(qǐng)求參數(shù)不僅包含參與簽名的參數(shù)，還包含參數(shù)sign、sign_type。 避免接口無(wú)法正常使用傳遞請(qǐng)求出錯(cuò)時(shí)的通知頁(yè)面路徑error_notify_url（需要聯(lián)系支付寶開(kāi)通該參數(shù)權(quán)限） 方便商戶定位接口報(bào)錯(cuò)發(fā)送給支付寶的請(qǐng)求，如果使用form表單傳輸，需要按照以下要求編寫： action的值必須為“https://mapi.alipay.com/gateway.do?_input_charset=該值”，如：https://mapi.alipay.com/gateway.do?_input_charset=utf-8。 不允許寫成完整的請(qǐng)求鏈接地址，即禁止https://mapi.alipay.com/gateway.do?后帶有所有要請(qǐng)求給支付寶的請(qǐng)求參數(shù)數(shù)據(jù)； <form>與</form>之間需包含所有要請(qǐng)求給支付寶的參數(shù)，且每個(gè)參數(shù)的格式為<input type="hidden" name="參數(shù)名" value="參數(shù)值" />； 在眾多請(qǐng)求參數(shù)中，請(qǐng)求參數(shù)_input_charset（編碼格式）必須存在于form表單中，即form表單中必須含有<input type="hidden" name="_input_charset" value="參數(shù)值">； <form>與</form>之間包含的數(shù)據(jù)只允許是要請(qǐng)求給支付寶的參數(shù)，禁止出現(xiàn)商戶自行命名，不在接口技術(shù)文檔請(qǐng)求參數(shù)列表中的其他數(shù)據(jù)； form表單的method屬性，可自行選擇get、post兩種。 避免請(qǐng)求支付寶時(shí)報(bào)錯(cuò)，錯(cuò)誤碼為ILLEGAL_SIGN； 在win7系統(tǒng)下，如果瀏覽器是IE8以上，有可能出現(xiàn)發(fā)送請(qǐng)求鏈接時(shí)會(huì)無(wú)法跳轉(zhuǎn)到支付寶，當(dāng)前頁(yè)面為空白頁(yè)的情況。數(shù)據(jù)傳輸 必須使用https協(xié)議，支持get、post或者h(yuǎn)ttpclient方式提交。 避免接口無(wú)法正常使用設(shè)置了請(qǐng)求參數(shù)item_orders_info的情況下，建議使用post方式提交請(qǐng)求。 避免地址欄中地址數(shù)據(jù)過(guò)長(zhǎng)，導(dǎo)致傳遞的數(shù)據(jù)丟失。通知返回驗(yàn)證 如果有設(shè)置通知路徑及觸發(fā)條件，則必須使用獲取到的參數(shù)notify_id再次請(qǐng)求支付寶，獲取是否是支付寶發(fā)送的驗(yàn)證結(jié)果。該請(qǐng)求鏈接是：https://mapi.alipay.com/gateway.do?partner=合作者身份ID¬ify_id=通知ID的值 驗(yàn)證是否是支付寶發(fā)來(lái)的請(qǐng)求在對(duì)通知的參數(shù)做簽名時(shí)，這些參數(shù)必須來(lái)源于支付寶通知回來(lái)的參數(shù)，并且除去列表中的參數(shù)sign、sign_type，根據(jù)參數(shù)名=參數(shù)值的格式，按首字符字典順序（ascii值大�。┡判�，若遇到相同首字符，則判斷第二個(gè)字符，以此類推，待簽名字符串需要以“參數(shù)名1=參數(shù)值1&參數(shù)名2=參數(shù)值2&….&參數(shù)名N=參數(shù)值N”的規(guī)則進(jìn)行拼接，得到的簽名結(jié)果與獲取到的參數(shù)sign值做比較。 驗(yàn)證返回的簽名返回?cái)?shù)據(jù)處理 支付寶主動(dòng)發(fā)送通知，當(dāng)商戶接收到通知數(shù)據(jù)后必須給支付寶返回“success”字符串，不允許返回其他多余字符。 如果商戶返回給支付寶的信息不是“success”，支付寶最多重復(fù)發(fā)送8次通知。 說(shuō)明：一旦商戶收到異步通知返回了純字符串success給支付寶，支付寶就不會(huì)再發(fā)送異步通知，否則會(huì)繼續(xù)按照發(fā)送時(shí)間發(fā)送通知。必須保證設(shè)置的通知路徑互聯(lián)網(wǎng)上能訪問(wèn)得到，且訪問(wèn)順暢。 避免接收不到支付寶發(fā)送的通知必須對(duì)返回的所有結(jié)果數(shù)據(jù)進(jìn)行處理 以便商戶能夠了解接口的使用情況，以及進(jìn)行商戶的后續(xù)業(yè)務(wù)操作。必須判斷發(fā)送支付請(qǐng)求以后的業(yè)務(wù)邏輯處理程序是否有重復(fù)執(zhí)行 防止出現(xiàn)商戶的業(yè)務(wù)操作被重復(fù)執(zhí)行，導(dǎo)致出現(xiàn)資金損失，如重復(fù)充值、重復(fù)付款等。如果交易付款完成時(shí)發(fā)送的交易狀態(tài)是TRADE_SUCCESS（可對(duì)交易做其他操作，如退款、分潤(rùn)等），則當(dāng)超過(guò)簽約合同指定的可退款時(shí)間段時(shí)，支付寶會(huì)主動(dòng)發(fā)送TRADE_FINISHED（不能對(duì)該交易再做任何操作）交易狀態(tài)。此時(shí)，需要根據(jù)商戶自身業(yè)務(wù)情況，來(lái)判斷是否需對(duì)這次的交易完成通知進(jìn)一步處理。 防止出現(xiàn)商戶的業(yè)務(wù)操作被重復(fù)執(zhí)行，導(dǎo)致出現(xiàn)資金損失，如重復(fù)充值、重復(fù)付款或訂單數(shù)據(jù)錯(cuò)亂等。建議每一次支付操作需以日志形式記錄到商戶網(wǎng)站的日志操作數(shù)據(jù)庫(kù)中 用來(lái)在必要時(shí)檢查或跟蹤業(yè)務(wù)處理情況接入環(huán)境 不能把接口嵌入iframe框架中 避免接口無(wú)法正常使用錯(cuò)誤碼處理 常見(jiàn)錯(cuò)誤碼問(wèn)題，請(qǐng)參見(jiàn)：http://help.alipay.com/support/234878-235357/0-235357.htm?sh=Y&info_type=9該鏈接中記載了常見(jiàn)錯(cuò)誤碼問(wèn)題解決方案遇到特殊錯(cuò)誤碼（如：UNKNOWN_EXCEPTION、GENERIC_FAILURE、SYSTEM_ERROR），須暫停后續(xù)一切操作，或者聯(lián)系支付寶技術(shù)支持協(xié)助處理。 一般這種情況有可能請(qǐng)求已經(jīng)提交到支付寶，支付寶系統(tǒng)失去響應(yīng)但有可能由恢復(fù)機(jī)制自動(dòng)回復(fù)并提交請(qǐng)求。如果遇到錯(cuò)誤碼“TRADE_BUYER_NOT_MATC”，表明支付使用的賬戶與原來(lái)的不一致，請(qǐng)使用原來(lái)的賬戶，或重新創(chuàng)建交易付款。 出現(xiàn)這種情況是買家賬戶不一致，或者買家使用多個(gè)賬戶，支付時(shí)賬戶必須與購(gòu)買時(shí)賬戶（創(chuàng)建交易賬戶）一致。如果遇到錯(cuò)誤碼“ILLEGAL_FEE_PARAM”，表明交易金額錯(cuò)誤，請(qǐng)檢查交易金額是否正確。 遵循如下規(guī)則： 總價(jià)和單價(jià)不可以同時(shí)出現(xiàn)； 如果存在總價(jià)，則應(yīng)該輸入商品數(shù)量，如果未輸入商品數(shù)量，系統(tǒng)不報(bào)錯(cuò)，默認(rèn)為1； 如果存在單價(jià)，則商品數(shù)量必須存在。如果遇到錯(cuò)誤碼“TRADE_PRICE_NOT_MATCH”、“TRADE_TOTALFEE_NOT_MATCH”，表明商品價(jià)格或總價(jià)可能發(fā)生了變化，請(qǐng)重新創(chuàng)建交易付款。 出現(xiàn)這種情況，可能是商品價(jià)格發(fā)生了變更。（例如：過(guò)了促銷期等）如果遇到錯(cuò)誤碼“FAIL_CREATE_CASHIER_PAY_ORDER”，可能是支付寶收銀臺(tái)系統(tǒng)出現(xiàn)異常，請(qǐng)稍候重試或聯(lián)系支付寶技術(shù)支持協(xié)助處理。 一般是支付寶收銀臺(tái)系統(tǒng)出現(xiàn)異常錯(cuò)誤碼“BUYER_EMAIL_ID_MUST_NULL”表示使用純網(wǎng)關(guān)產(chǎn)品時(shí)輸入了買家賬號(hào) 使用純網(wǎng)關(guān)產(chǎn)品不需要輸入買家賬號(hào)錯(cuò)誤碼“DIRECTIONAL_PAY_FORBIDDEN”表示買家、平臺(tái)商、賣家、分潤(rùn)方不符合定向支付條件。 可能原因： 買家未簽署定向支付協(xié)議； 買家簽署了定向支付協(xié)議，但買家、平臺(tái)商、賣家不符合定向支付條件；或者買家、平臺(tái)商、分潤(rùn)方不符合定向支付條件。如果交易狀態(tài)是“TRADE_CLOSED”，可能是交易超時(shí)。 交易超過(guò)時(shí)限自動(dòng)關(guān)閉如果交易狀態(tài)出現(xiàn)“TRADE_PENDING”，則表明收款方賬號(hào)未激活或收款方賬號(hào)被鎖定，請(qǐng)重新登錄支付寶激活賬號(hào)。 收款方賬號(hào)未激活或收款方賬號(hào)被鎖定自主編寫接口代碼規(guī)則 如果不使用支付寶提供的代碼示例來(lái)集成接口，那么必須根據(jù)技術(shù)文檔中簽名機(jī)制和通知返回?cái)?shù)據(jù)處理章節(jié)及本文檔的技術(shù)接入規(guī)則、接口使用規(guī)則、測(cè)試流程規(guī)則，來(lái)編寫符合商戶網(wǎng)站項(xiàng)目的接口代碼。 避免接口無(wú)法正常使用4 接口使用規(guī)則表4-1 接口使用規(guī)則類型規(guī)范點(diǎn)原因業(yè)務(wù)操作 接口支持重復(fù)調(diào)用，前提是交易基本信息（買家、賣家、交易金額、超時(shí)時(shí)間等）在多次調(diào)用中保持一致，且交易尚未完成支付。 防止重復(fù)付款以及交易信息被篡改 說(shuō)明： 如果發(fā)現(xiàn)買家不一致、賣家不一致或交易金額不一致，系統(tǒng)會(huì)報(bào)錯(cuò)不能繼續(xù)支付； 如果超時(shí)時(shí)間不一致，則交易狀態(tài)為等待買家支付，但買家支付時(shí)系統(tǒng)會(huì)報(bào)錯(cuò)。即時(shí)到賬的優(yōu)勢(shì)：快捷，不存在賣家發(fā)貨、買家確認(rèn)收貨的操作，直接將買家的資金轉(zhuǎn)入賣家的支付寶賬號(hào)。 即時(shí)到賬交易主要用于虛擬物品和不存在賣家發(fā)貨、買家確認(rèn)收貨的交易場(chǎng)景，比如手機(jī)話費(fèi)交易、游戲幣充值、網(wǎng)上訂餐類網(wǎng)站等。填寫買家支付寶賬號(hào)時(shí)，不能與賣家的支付寶賬號(hào)相同。 避免報(bào)錯(cuò)，如錯(cuò)誤碼：BUYER_SELLER_EQUAL。即時(shí)到賬交易不允許賣家在交易創(chuàng)建后修改價(jià)格 會(huì)影響同一筆交易的支付支付寶每一次退款成功，都會(huì)向商戶的即時(shí)到賬異步通知地址notify_url發(fā)送一條交易成功的通知，其中狀態(tài)有refund_status、refund_success。注意： 商戶要注意做防訂單重復(fù)更新的代碼處理。 交易關(guān)閉的狀態(tài)不會(huì)發(fā)送通知，因此當(dāng)進(jìn)行全額退款操作時(shí)，會(huì)出現(xiàn)收不到通知的情況，而在部分退款操作時(shí)，能收到即時(shí)到賬接口的交易通知。 解決方案是： 商戶使用退款接口，把退款的商戶業(yè)務(wù)邏輯程序?qū)懙酵丝罱涌诘耐ㄖ?yè)面里去，而即時(shí)到賬接口中不對(duì)退款的通知做任何判斷。如果不處理或者處理錯(cuò)誤會(huì)將商戶自己的業(yè)務(wù)邏輯執(zhí)行2次以上如果商戶的一筆交易在退款期限內(nèi)，沒(méi)有進(jìn)行退款操作，則支付寶系統(tǒng)會(huì)默認(rèn)將交易的狀態(tài)改為“交易完成”（即不可退款模式），并主動(dòng)發(fā)送一條交易狀態(tài)為trade_finished的異步通知（可以聯(lián)系支付寶關(guān)閉發(fā)送），商戶需要根據(jù)通知，結(jié)合自身業(yè)務(wù)邏輯做交易不可退款的數(shù)據(jù)庫(kù)狀態(tài)變更。 處理錯(cuò)誤會(huì)導(dǎo)致商戶業(yè)務(wù)邏輯重復(fù)2次付款成功本接口支持的眾多支付通道中，儲(chǔ)蓄卡支付和信用卡支付一旦進(jìn)入網(wǎng)銀系統(tǒng)頁(yè)面，支付寶將無(wú)法控制訂單的支付效率問(wèn)題。 便于做支付渠道區(qū)分如果想要買家不安裝數(shù)字證書也能進(jìn)行余額支付，商戶需要申請(qǐng)開(kāi)通非證書余額支付功能；否則，買家必須申請(qǐng)安裝數(shù)字證書才能用支付寶余額支付。 說(shuō)明：該種情況只有在買家從來(lái)沒(méi)有申請(qǐng)過(guò)數(shù)字證書的情況下才有效。 保護(hù)買家賬戶安全平級(jí)分潤(rùn)規(guī)則 平級(jí)分潤(rùn)格式：收款方Email_1^金額1^備注1|收款方Email_2^金額2^備注2功能效果：買家付出了交易金額100元，同時(shí)，金額1給了收款方Email_1，金額2給了收款方Email_2，seller_email獲得剩下的金額（剩下的金額為：100-金額1-金額2-支付寶手續(xù)費(fèi)）。金額計(jì)算規(guī)則： 買家交易金額=金額1+金額2+seller_email收款金額+支付寶手續(xù)費(fèi) 收款方Email_1實(shí)際獲得金額=金額1 收款方Email_2實(shí)際獲得金額=金額2 seller_email實(shí)際獲得金額=買家交易金額-金額1-金額2-支付寶手續(xù)費(fèi)分潤(rùn)規(guī)則，避免出現(xiàn)分潤(rùn)錯(cuò)誤。多級(jí)分潤(rùn)規(guī)則 多級(jí)分潤(rùn)格式：收款方Email_1^金額1^備注1|收款方Email_1^收款方Email_2^金額2^備注2功能效果：買家付出了交易金額100元，同時(shí)，金額1給了收款方Email_1，收款方Email_1把獲得的金額中的金額2給了收款方Email_2，seller_email獲得剩下的金額（剩下的金額可以為：100-金額1-支付寶手續(xù)費(fèi)）。金額計(jì)算規(guī)則： 買家交易金額=金額1+seller_email收款金額+支付寶手續(xù)費(fèi) 收款方Email_1實(shí)際獲得金額=金額1-金額2（金額1必須大于等于金額2） 收款方Email_2實(shí)際獲得金額=金額2 seller_email實(shí)際獲得金額=買家交易金額-金額1-支付寶手續(xù)費(fèi)分潤(rùn)規(guī)則，避免出現(xiàn)分潤(rùn)錯(cuò)誤。限額 使用借記卡快捷支付時(shí)，系統(tǒng)會(huì)先根據(jù)后臺(tái)配置的借記卡快捷額度檔次來(lái)進(jìn)行限額；如果后臺(tái)未配置額度檔次，則會(huì)根據(jù)商戶簽約大快捷產(chǎn)品借記卡快捷渠道信息中的額度控制檔次來(lái)進(jìn)行限額；如果后臺(tái)以及簽約信息中也未設(shè)置額度檔次，則默認(rèn)使用A檔限額；如果商戶后臺(tái)未設(shè)置額度檔次且商戶未簽約大快捷產(chǎn)品借記卡快捷渠道，可使用借記卡快捷體驗(yàn)B檔額度。借記卡快捷額度檔次共分為4個(gè)檔次，其中： A檔：?jiǎn)喂P和單日2萬(wàn)限額，單月5萬(wàn)限額； B檔：?jiǎn)喂P和單日2千限額，單月1萬(wàn)限額； C檔：?jiǎn)喂P和單日500限額，單月1千限額； O檔：?jiǎn)喂P、單日和單月無(wú)限額。控制借記卡支付風(fēng)險(xiǎn)使用信用卡快捷支付時(shí)，系統(tǒng)會(huì)先根據(jù)商戶簽約大快捷產(chǎn)品信用卡快捷渠道信息中的額度控制檔次來(lái)進(jìn)行限額；如果簽約了大快捷產(chǎn)品信用卡快捷渠道且未設(shè)置額度檔次，或簽約了獨(dú)立的信用卡快捷產(chǎn)品，則默認(rèn)使用A檔限額；如果商戶未簽約大快捷產(chǎn)品信用卡快捷渠道且未簽約信用卡快捷產(chǎn)品，可使用信用卡快捷體驗(yàn)C檔額度。信用卡快捷額度檔次共分為3個(gè)檔次，其中： A檔：?jiǎn)喂P、單日和單月無(wú)限額； B檔：?jiǎn)喂P和單日2千限額，單月1萬(wàn)限額； C檔：?jiǎn)喂P和單日500限額，單月1千限額。控制信用卡支付風(fēng)險(xiǎn)使用余額支付時(shí)，系統(tǒng)會(huì)先根據(jù)后臺(tái)配置的余額額度檔次來(lái)進(jìn)行限額；如果后臺(tái)未配置額度檔次，則會(huì)根據(jù)商戶簽約信息中的額度控制檔次來(lái)進(jìn)行限額；如果后臺(tái)及簽約信息中也未設(shè)置額度檔次或者商戶未簽約大快捷產(chǎn)品，則默認(rèn)使用A檔限額。余額額度檔次共分為4個(gè)檔次，其中： A檔：?jiǎn)喂P和單日2萬(wàn)限額，單月5萬(wàn)限額； B檔：?jiǎn)喂P和單日2千限額，單月1萬(wàn)限額； C檔：?jiǎn)喂P和單日500限額，單月1千限額； O檔：?jiǎn)喂P、單日和單月無(wú)限額。 控制余額支付風(fēng)險(xiǎn)業(yè)務(wù)應(yīng)用注意事項(xiàng) 如果商戶簽約的是純網(wǎng)關(guān)，那么必須配置請(qǐng)求參數(shù)paymethod為bankPay，defaultbank為某家銀行簡(jiǎn)碼。 如果沒(méi)有設(shè)置這兩個(gè)請(qǐng)求參數(shù)，那么支付寶就不會(huì)按照純網(wǎng)關(guān)的手續(xù)費(fèi)來(lái)收取，而是按照即時(shí)到賬接口收取費(fèi)用，導(dǎo)致商戶多支出費(fèi)用。站內(nèi)不能關(guān)閉交易，只能通過(guò)站外接口關(guān)閉交易。可通過(guò)自定義超時(shí)參數(shù)實(shí)現(xiàn)控制交易關(guān)閉時(shí)間。 交易訂單自定義超時(shí)關(guān)閉功能當(dāng)商戶開(kāi)通了純網(wǎng)關(guān)、大額信用卡、信用卡分期、快捷支付前置、快捷支付網(wǎng)關(guān)之中的一個(gè)功能時(shí)，使用請(qǐng)求參數(shù)defaultbank（默認(rèn)網(wǎng)銀）后，用戶付款時(shí)支付寶會(huì)自動(dòng)略過(guò)網(wǎng)銀選擇界面。各功能都有自己的網(wǎng)銀簡(jiǎn)碼列表，具體請(qǐng)參考接口技術(shù)文檔的附錄部分。 不同功能使用不同的網(wǎng)銀簡(jiǎn)碼才能達(dá)到網(wǎng)銀前置的效果 在快捷支付前置接口中，請(qǐng)求參數(shù)default_login可設(shè)置也可不設(shè)置； 在快捷支付網(wǎng)關(guān)接口中，請(qǐng)求參數(shù)default_login必須設(shè)置。在快捷支付前置接口中，不設(shè)置該參數(shù)不會(huì)影響快捷支付前置功能；但在快捷支付網(wǎng)關(guān)接口中，則會(huì)出現(xiàn)不能正常付款的情況。一般情況下，異步通知比同步通知慢3秒左右。但在網(wǎng)絡(luò)環(huán)境、服務(wù)器處理速度等因素影響下，有時(shí)異步通知會(huì)比同步通知快一些，所以商戶需要使用數(shù)據(jù)庫(kù)數(shù)據(jù)鎖防止訂單重復(fù)更新。 即時(shí)到賬異步通知與同步通知時(shí)間支付寶支付手續(xù)費(fèi)扣取模式分為兩種： 實(shí)時(shí)扣費(fèi)模式：一般都是收款賬戶扣費(fèi)，或采用合同指定固定扣款支付寶賬戶扣費(fèi)； 月結(jié)手續(xù)費(fèi)模式：實(shí)時(shí)交易不扣手續(xù)費(fèi)，月底賬單統(tǒng)一結(jié)算。實(shí)時(shí)扣費(fèi)時(shí)，在扣費(fèi)支付寶賬號(hào)的賬務(wù)明細(xì)中可馬上查到扣費(fèi)記錄；但月結(jié)模式下，則不會(huì)查到。如果商戶請(qǐng)求時(shí)傳遞了extra_common_param參數(shù)，支付寶會(huì)在同步和異步通知中返回該參數(shù)。 支持商戶自定義公用回傳參數(shù)（extra_common_param）建議商戶不要使用類似js的window.open、location.replace等沒(méi)有訪問(wèn)記錄的重定向函數(shù)跳轉(zhuǎn)到支付網(wǎng)關(guān)，強(qiáng)烈建議使用form表單提交數(shù)據(jù)。 規(guī)范代碼使用規(guī)則及減少?gòu)棾隹丶䲠r截支付（導(dǎo)致支付成功率下降）在集成接口的過(guò)程中，如果商戶使用seller_email作為收款賬戶，則當(dāng)需要修改該支付寶賬戶名稱時(shí)，商戶必須在程序中做相應(yīng)修改，否則在支付過(guò)程中會(huì)出現(xiàn)賣家賬戶不存在的錯(cuò)誤。推薦使用seller_id做為商戶收款賬戶。 seller_id值是支付寶分配給商戶的唯一身份ID，不會(huì)改變，使用seller_id作為收款賬戶可以避免seller_email變更導(dǎo)致商戶無(wú)法收款的問(wèn)題。（可在集成時(shí)聯(lián)系支付寶技術(shù)支持獲取seller_id值。）賣家發(fā)起退款操作后，買家是通過(guò)什么渠道付款的，則款項(xiàng)原路退回。比如，買家用的是支付寶賬號(hào)余額付款，則錢退回到支付寶賬號(hào)；借記卡付款，則退回借記卡；信用卡付款，則退回信用卡。 買家通過(guò)何種渠道付款，則款項(xiàng)原路退回。5 測(cè)試流程規(guī)則表5-1 測(cè)試流程規(guī)則步驟調(diào)試內(nèi)容備注Windows環(huán)境（linux環(huán)境）服務(wù)器配置要求：推薦配置Java 1.6以上運(yùn)行環(huán)境，符合servlet2.4規(guī)范的WEB容器。第一步：在本機(jī)單獨(dú)對(duì)這個(gè)接口進(jìn)行調(diào)試。 支付 返回僅僅把接口配置好，不要放在商戶的網(wǎng)站項(xiàng)目中。第二步：在服務(wù)器上單獨(dú)對(duì)這個(gè)接口進(jìn)行調(diào)試 支付 返回 通知本機(jī)調(diào)試沒(méi)有問(wèn)題后，再放入服務(wù)器中調(diào)試。第三步：接口融合到網(wǎng)站項(xiàng)目中 無(wú) 把調(diào)試好的接口與商戶網(wǎng)站項(xiàng)目的業(yè)務(wù)流程進(jìn)行銜接和融合。第四步：在本機(jī)對(duì)融合后的網(wǎng)站項(xiàng)目進(jìn)行調(diào)試 整個(gè)業(yè)務(wù)操作流程 支付 返回 業(yè)務(wù)后續(xù)的執(zhí)行在本機(jī)調(diào)試銜接到網(wǎng)站項(xiàng)目后的接口。第五步：在服務(wù)器對(duì)融合后的網(wǎng)站項(xiàng)目進(jìn)行調(diào)試 整個(gè)業(yè)務(wù)操作流程 支付 返回 通知 業(yè)務(wù)后續(xù)的執(zhí)行本機(jī)調(diào)試沒(méi)有問(wèn)題后，再放入服務(wù)器中調(diào)試。世聯(lián)翻譯-讓世界自由溝通！專業(yè)的全球語(yǔ)言翻譯供應(yīng)商，上海翻譯公司專業(yè)品牌。絲路沿線56種語(yǔ)言一站式翻譯與技術(shù)解決方案，專業(yè)英語(yǔ)翻譯、日語(yǔ)翻譯等文檔翻譯、同傳口譯、視頻翻譯、出國(guó)外派服務(wù)，加速您的全球交付。 世聯(lián)翻譯公司在北京、上海、深圳等國(guó)際交往城市設(shè)有翻譯基地，業(yè)務(wù)覆蓋全國(guó)城市。每天有近百萬(wàn)字節(jié)的信息和貿(mào)易通過(guò)世聯(lián)走向全球！積累了大量政商用戶數(shù)據(jù)，翻譯人才庫(kù)數(shù)據(jù)，多語(yǔ)種語(yǔ)料庫(kù)大數(shù)據(jù)。世聯(lián)品牌和服務(wù)品質(zhì)已得到政務(wù)防務(wù)和國(guó)際組織、跨國(guó)公司和大中型企業(yè)等近萬(wàn)用戶的認(rèn)可。
