alipay支付寶標(biāo)準(zhǔn)快速付款接口文檔(編輯修改稿)
2024-08-11 22:05 本頁面
【文章內(nèi)容簡介】 seller_idString(30)賣家IDY買家IDbuyer_idString(30)買家EmailY買家Emailbuyer_String(100)買家IDY是否使用紅包use_couponString(1)買家是否在交易過程中使用了紅包Y錯(cuò)誤通知參數(shù)信息（需要在傳入?yún)?shù)增加錯(cuò)誤通知地址）：錯(cuò)誤代碼error_codeString(說明接口調(diào)用過程中的出錯(cuò)信息N 接口注意事項(xiàng)l 您需使用HTTPS 協(xié)義, 支付寶是以HTTPS的形式進(jìn)行通知l 請按照支付寶外部請求接口概述中要求的簽名方式，對輸入?yún)?shù)進(jìn)行簽名，該接口請求才能夠被支付寶系統(tǒng)接收l 該接口支持重復(fù)調(diào)用，即：一筆訂單可以重新支付，但是前提是這筆訂單的信息和原來信息一樣，否則會(huì)報(bào)訂單號(hào)重復(fù)l 處理支付寶的返回信息可以異步處理也可以同步處理，前提是防止訂單重復(fù)接收l 提成數(shù)據(jù)集：1. 收款方Email_1^金額^備注|付款方Email^收款方Email_2^金額^備注例如：gwl251@^^分潤1|gwl251@^gwl061@^^分潤22. 收款方Email_1^金額^備注|收款方Email_2^金額^備注例如：gwl251@^^分潤1|gwl061@^^分潤2^金額^備注|收款方Email_1^收款方Email_2^金額^備注例如：gwl251@^^分潤1|gwl251@^gwl061@^^分潤2 接口錯(cuò)誤代碼列表 錯(cuò)誤代碼（error_code）說明ILLEGAL_SIGN簽名驗(yàn)證出錯(cuò)ILLEGAL_ARGUMENT參數(shù)不正確HAS_NO_PRIVILEGE沒有權(quán)限訪問該服務(wù)ILLEGAL_SERVICEService參數(shù)不正確ILLEGAL_PARTNER商戶ID不正確HAS_NO_PUBLICKEY沒有上傳公鑰USER_NOT_EXIST會(huì)員不存在OUT_TRADE_NO_EXIST外部交易號(hào)已經(jīng)存在TRADE_NOT_EXIST交易不存在ILLEGAL_PAYMENT_TYPE無效支付類型，需要聯(lián)系支付寶技術(shù)支持工程師處理BUYER_NOT_EXIST買家不存在SELLER_NOT_EXIST賣家不存在BUYER_SELLER_EQUAL買家、賣家是同一帳戶ILLEGAL_SIGN_TYPE簽名類型不正確COMMISION_ID_NOT_EXIST傭金收取帳戶不存在COMMISION_SELLER_DUPLICATE收取傭金帳戶和賣家是同一帳戶COMMISION_FEE_OUT_OF_RANGE傭金金額超出范圍ILLEGAL_LOGISTICS_FORMAT無效物流格式TOTAL_FEE_LESSEQUAL_ZERO交易總金額小于等于0TOTAL_FEE_OUT_OF_RANGE交易總金額超出范圍ILLEGAL_FEE_PARAM非法交易金額格式（參考單價(jià)、總價(jià)、數(shù)量三個(gè)組合規(guī)則）DONATE_GREATER_THAN_MAX小額捐贈(zèng)總金額超出最大值限制DIRECT_PAY_AMOUNT_OUT_OF_RANGE快速付款交易總金額超出最大值限制DIGITAL_FEE_GREATER_THAN_MAX虛擬物品交易總金額超出最大值限制SELF_TIMEOUT_NOT_SUPPORT不支持自定義超時(shí)COMMISION_NOT_SUPPORT不支持傭金VIRTUAL_NOT_SUPPORT不支持虛擬發(fā)貨方式ILLEGAL_CHARSET字符集不合法ROYALTY_SELLER_ENABLE_STATUS_FORBID有提成情況下，賣家狀態(tài)不正常ROYALTY_SELLER_NOT_CERTIFY有提成情況下，賣家未通過認(rèn)證ROYALTY_FORAMT_ERROR提成信息錯(cuò)誤，請檢查后重新集成ROYALTY_TYPE_ERROR提成類型不支持，請檢查后重新集成ROYALTY_PAY_EMAIL_NOT_EXIST提成付款帳戶不存在ROYALTY_RECEIVE_EMAIL_NOT_EXIST提成收款帳戶不存在DEFAULT_BANK_MUST_NOT_NULL默認(rèn)網(wǎng)銀不能為空LLEGAL_PAYMENT_TYPE錯(cuò)誤的Payment_type參數(shù)ILLEGAL_OUTTIME_ARGUMENT自定義超時(shí)參數(shù)錯(cuò)誤CANT_CREDIT_PAY不能使用信用支付TRADE_NOT_ALLOWED_PAY交易不允許付款NAVIGATION_INCOME_OF_ROYALTY_ACCOUNT在提成情況下的多級(jí)分潤，二次分潤帳戶次序問題或者分潤時(shí)沒有預(yù)留支付寶服務(wù)費(fèi)3 簽名通用策略 安全方面CheckLista 從集成后的系統(tǒng)健壯性考慮，收到支付寶發(fā)出的通知后，合作伙伴系統(tǒng)須判斷接收到的交易狀態(tài)、交易金額是否與自己系統(tǒng)中的參數(shù)對應(yīng)，并處理這些數(shù)據(jù)信息，使網(wǎng)站內(nèi)的交易信息與支付寶內(nèi)的交易信息保持一致，可防止掉單情況出現(xiàn)。如果不判斷，存在潛在的風(fēng)險(xiǎn)，合作伙伴自行承擔(dān)因此而產(chǎn)生的所有損失。 簽名方面 簽名機(jī)制a 沒有值的參數(shù)無需傳遞，也無需包含到待簽名數(shù)據(jù)中。b 簽名時(shí)將字符轉(zhuǎn)變成字節(jié)流時(shí)指定的字符集要與_input_charset保持一致。c 如果傳遞了_input_charset參數(shù)，那么這個(gè)參數(shù)也應(yīng)該包含在待簽名數(shù)據(jù)中。d 根據(jù)HTTP協(xié)議要求，傳遞參數(shù)的值中如果存在特殊字符（如：amp。、@等），那么該值需要做URL Encoding，這樣請求接受方才能接受到正確的參數(shù)值。這種情況下，做簽名時(shí)使用的應(yīng)該是原生值而不是encoding之后的值。例如：會(huì)員查詢接口示例中待簽名數(shù)據(jù)是=test@amp。partner=2088006300000000amp。service=test，而不是=test%amp。partner=2088006300000000amp。service=test。 按照sign_type參數(shù)指定的簽名算法對待簽名數(shù)據(jù)進(jìn)行簽名【參見：數(shù)字簽名構(gòu)造】 其他方面1) 您必需使用HTTPS 協(xié)義, 支付寶是以HTTPS的形式進(jìn)行通知2) 請按照支付寶外部請求接口概述中要求的簽名方式，對輸入?yún)?shù)進(jìn)行簽名，該接口請求才能夠被支付寶系統(tǒng)接收3) 如果設(shè)置了notify_url，支付寶會(huì)發(fā)一條通知到notify_url對應(yīng)的站點(diǎn)4) 通知URL不要如此設(shè)置：...，即不要帶自加的自定義參數(shù)，這會(huì)導(dǎo)致通知返回時(shí)判斷失敗。4 附錄 接口通用機(jī)制 系統(tǒng)調(diào)用顧名思義，這類接口是為合作伙伴系統(tǒng)獲得支付寶系統(tǒng)信息提供服務(wù)的，是一種系統(tǒng)間的調(diào)用接口。 系統(tǒng)調(diào)用示意圖 頁面跳轉(zhuǎn)顧名思義，這類接口都是一些有頁面操作的接口。通常是用戶在合作伙伴頁面執(zhí)行部分操作，然后跳轉(zhuǎn)到支付寶系統(tǒng)記錄訂單信息及時(shí)再轉(zhuǎn)入網(wǎng)銀系統(tǒng)頁面完成整個(gè)操作。有的甚至可能最后還要再跳回到合作伙伴的下一個(gè)頁面，繼續(xù)完成整個(gè)操作。
環(huán)評(píng)公示相關(guān)推薦
鄂ICP備17016276號(hào)-1