支付寶即時(shí)分潤(rùn)接口文檔

1、分潤(rùn)接口參數(shù)和實(shí)例文檔 最后修改時(shí)間：2008-8-21修改 by：甘寧1. 分潤(rùn)接口接口類型系統(tǒng)調(diào)用輸入?yún)?shù)字段名變量名類型說明可空協(xié)議參數(shù)接口名稱serviceStringdistribute_royaltyN簽名signString見簽名機(jī)制N簽名方式sign_typeString見簽名方式N合作伙伴IDpartnerString(16)合作伙伴在支付寶的用戶IDN通知URLnotify_urlURL針對(duì)該交易的交易狀態(tài)異步通知接收URL。N業(yè)務(wù)參數(shù)外部交易號(hào)out_trade_noString(64)外部交易號(hào)（商戶網(wǎng)站訂單）和外部交易號(hào)不可同時(shí)為空。二選其一即可Y支付寶交易號(hào)trad

2、e_noString(16)Y外部分潤(rùn)號(hào)out_bill_noString(20)外部單據(jù)號(hào),一個(gè)合作伙伴中唯一N提成類型royalty_typeString(2)目前只支持一種類型： 10Y提成信息集royalty_parametersString(500)分潤(rùn)收款賬號(hào)1提成金額1說明1|分潤(rùn)付款賬號(hào)2分潤(rùn)收款賬號(hào)2提成金額2說明2單次條數(shù)不超過10條說明不能超過30個(gè)字符，不能有和|符號(hào)注意:當(dāng)分潤(rùn)信息中沒有顯式指明分潤(rùn)付款賬號(hào)時(shí),分潤(rùn)付款賬戶默認(rèn)為賣家賬戶Y輸出參數(shù)response返回:字段名變量名類型說明可空協(xié)議參數(shù)是否成功is_successStringT,FY錯(cuò)誤碼errorStr

3、ing錯(cuò)誤原因,當(dāng)is_success為F時(shí)不可為空Y使用說明何時(shí)使用:買家付完款后,交易未超時(shí),且交易未關(guān)閉時(shí)可以調(diào)用注意事項(xiàng):royalty_parameters分潤(rùn)參數(shù),分潤(rùn)參數(shù)順序問題:分潤(rùn)順序按參數(shù)傳入順序執(zhí)行,所有分潤(rùn)必須滿足”入大于出,先入后出”原則;每次調(diào)用分潤(rùn)接口進(jìn)行分潤(rùn)時(shí)必須傳入out_bill_no用以標(biāo)識(shí),當(dāng)同一out_bill_no之前已分潤(rùn)成功,重復(fù)調(diào)用時(shí)返回成功(前后兩次的分潤(rùn)參數(shù)必須完全相同)。2. 附錄：A.常見錯(cuò)誤：錯(cuò)誤代碼（error_code）說明協(xié)議層錯(cuò)誤代碼ILLEGAL_SIGN簽名驗(yàn)證出錯(cuò)ILLEGAL_ARGUMENT參數(shù)格式有問題ILLEGA

4、L_SERVICE無效接口名稱ILLEGAL_PARTNER無效合作伙伴IDILLEGAL_SIGN_TYPE無效簽名方式ILLEGAL_CHARSET無效字符集HAS_NO_PUBLICKEY沒有上傳公鑰HASH_NO_PRIVILEGE沒有權(quán)限訪問該服務(wù)SYSTEM_ERROR支付寶系統(tǒng)出錯(cuò)OUTBILLNO_TOO_LONG外部分潤(rùn)號(hào)大于16位TRADE_PASS_TIME_OR_NOT_SUCCESS交易超時(shí)或者沒有成功，這個(gè)由于使用外部訂單號(hào)導(dǎo)致TRADE_CAN_NOT_FOUND該交易不存在，這個(gè)由于使用外部訂單號(hào)導(dǎo)致NOT_CREATE_BY_PARTNER合作partnerI

5、D和原來下訂單的partnerID導(dǎo)致交易接口錯(cuò)誤代碼OUT_TRADE_NO_EXIST外部交易號(hào)已經(jīng)存在TRADE_NOT_EXIST交易不錯(cuò)在ILLEGAL_PAYMENT_TYPE無效支付類型BUYER_NOT_EXIST買家不存在SELLER_NOT_EXIST賣家不存在COMMISION_ID_NOT_EXIST傭金收取帳戶不存在COMMISION_SELLER_DUPLICATE收取傭金帳戶和賣家是同一帳戶COMMISION_FEE_OUT_OF_RANGE傭金金額超出范圍BUYER_SELLER_EQUAL買家、賣家是同一帳戶ILLEGAL_LOGISTICS_FORMAT無效

6、物流格式TOTAL_FEE_LESSEQUAL_ZERO交易總金額小于等于0TOTAL_FEE_OUT_OF_RANGE交易總金額超出范圍ILLEGAL_FEE_PARAM非法交易金額格式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不支

7、持虛擬發(fā)貨方式B. 簽名方式：簽名方式表：說明MD5待簽名數(shù)據(jù) + securityCode值（支付寶為合作伙伴頒發(fā)的安全校驗(yàn)碼）的MD5摘要作為簽例如： 安全校驗(yàn)碼是mysecurityCode，那么前面會(huì)員查詢接口示例的待簽名數(shù)據(jù)就email=test&partner=2088006300000000&service=user_querymysecurityCode。 DSA合作伙伴發(fā)送請(qǐng)求時(shí)，使用自己的密鑰對(duì)待簽名數(shù)據(jù)進(jìn)行DSA簽名，支付寶使用合作伙伴鑰進(jìn)行校驗(yàn)；支付寶返回?cái)?shù)據(jù)時(shí)，使用支付寶的密鑰對(duì)待簽名數(shù)據(jù)進(jìn)行DSA簽名，合作伙用支付寶的公鑰進(jìn)行校驗(yàn)。 DSA公私鑰可以使用OpenSSL生成，如下： 1. 生成DSA參數(shù) openssl dsaparam -out dsa_param.pem 1024 2. 生成私鑰 openssl gendsa