支付寶小程序:商家分賬
小編:啊南 383閱讀 2020.12.28
產品介紹簡介
境內商家分賬產品多面向電商、自助設備、零售業、票務、保險、出行等行業,提供商家與其合作方基于交易資金靈活分配的手段。商戶可根據自行業務特點自由組合,在不同場景下實現高效分潤。整個分賬過程不會造成資金的凍結。
商家或有授權的服務商,在劃轉資金前,首先通過分賬關系維護接口建立商家與分賬方的分賬關系。
建立分賬關系后,商家或有授權的服務商,通過分賬接口指定一筆交易,將資金實時劃轉到一個或多個分賬收入方的支付寶賬戶。目前分賬金額最高不能超過訂單金額的 30% 。
視頻講解使用說明分賬業務流程如下圖所示:
分賬收入方:與實際收款商家有合作關系的第三方,比如服務商,軟件供應商,供貨商等,接收分賬資金的商家或個人。
服務商:為實際收款商家提供各種產品,服務的提供方。
分賬關系集:分賬主體和分賬收入方之間的關系,稱為“分賬關系集”。簽約“境內商家分賬”,需要將分賬收入方維護在“分賬關系集”內,否則分賬會被攔截。可以通過分賬關系集維護接口來完成“分賬關系集”的添加、刪除和查詢。
應用場景B2C 電商平臺在 B2C 電商平臺自營模式下,用戶支付后,訂單資金收到平臺賬戶內,平臺根據與物流服務商、流量推廣方的約定進行分賬。
C2C 服務市場在 C2C 交易模式下,用戶支付并確認收貨后,訂單資金收到商家賬戶內,平臺根據與商家之間的約定,通過分賬產品收取傭金。
線下當面付收款在線下交易中,商家通過支付寶當面付產品收款,用戶支付后,訂單資金收到商家賬戶內,在經過商家授權后,線下服務商可通過分賬產品收取傭金,比如 POS 推廣、智能收銀設備服務費等。
關聯產品推薦在小程序場景下,商家分賬支持 小程序支付、周期扣款、資金預授權 等能力。
注意:目前收錢碼還不支持商家分賬功能。
準入條件-
該能力僅對企業支付寶賬戶開放。
-
個體工商戶如需使用商家分賬能力,可以通過 ISV 代簽約接入r。
注意:如果遇到當天收單進來的資金被凍結導致實時分賬失敗,請次日凌晨1點后嘗試分賬。
計費模式免費。
接入指引第一步:創建小程序要在您的小程序內使用?商家分賬功能,您需要首先完成 開發者入駐 并 創建小程序 。
第二步:添加能力并簽約小程序創建完成后,開發者登錄?開放平臺控制臺?> 找到已創建的小程序 > 點擊進入小程序管理后臺 > 在 版本管理 頁面的 能力列表 部分點擊添加能力 > 勾選 商家分賬 能力并點擊 確定 完成能力添加。商家分賬能力需要簽約才能生效,開發者點擊功能列表右側?簽約,提交相關信息。完成簽約后,需要一個工作日左右的時間審核(審批結果會以短信和郵件形式告知),待審核完畢后,功能的狀態會變成 已生效,即可使用商家分賬功能。
開放平臺服務端 SDK ,包含 JAVA、PHP、NodeJS、Python 和 .NET 五種語言,封裝了簽名 & 驗簽、HTTP 接口請求等基礎功能。請先下載對應語言版本的 SDK 并引入您的開發工程。
在 SDK 調用前需要進行初始化,以 JAVA 代碼為例:
AlipayClient alipayClient = new DefaultAlipayClient(URL,APP_ID,APP_PRIVATE_KEY,FORMAT,CHARSET,ALIPAY_PUBLIC_KEY,SIGN_TYPE);
配置參數 | 示例值解釋 | 獲取方式/示例值 |
URL | 支付寶網關(固定)。 | ?https://openapi.alipay.com/gateway.do? |
APPID | APPID 即創建應用后生成。 | 獲取見 創建應用。 |
APP_PRIVATE_KEY | 開發者私鑰,由開發者自己生成。 | 獲取見 配置密鑰。 |
FORMAT | 參數返回格式,只支持 json。 | json(固定) |
CHARSET | 編碼集,支持 GBK/UTF-8。 | 開發者根據實際工程編碼配置。 |
ALIPAY_PUBLIC_KEY | 支付寶公鑰,由支付寶生成。 | 獲取詳見 配置密鑰。 |
SIGN_TYPE | 商戶生成簽名字符串所使用的簽名算法類型,目前支持 RSA2 和 RSA,推薦使用 RSA2。 | RSA2 |
接下來,就可以用 alipayClient 來調用具體的 API 了。alipayClient 只需要初始化一次,后續調用不同的 API 都可以使用同一個 alipayClient 對象。
注意:ISV /開發者可以通過 第三方應用授權 得到商戶授權令牌(app_auth_token)作為請求參數傳入,實現代商戶發起請求的能力。
第四步:調用接口分賬關系維護開發者通過?alipay.trade.royalty.relation.bind?接口進行分賬關系維護操作,支持批量維護,最多支持建立?5000?個分賬關系。分賬關系維護交互流程如下所示:
開發者通過?alipay.trade.royalty.relation.unbind?接口進行分賬關系刪除操作,支持批量刪除。分賬關系刪除交互流程如下所示:
開發者通過?alipay.trade.royalty.relation.batchquery?接口進行分賬關系查詢操作,此接口支持分頁查詢。分賬關系查詢流程如下所示:
開發者通過?alipay.trade.order.settle?進行分賬請求,一次分賬最多可以分給 5 個分賬收入方,基于一筆訂單可支持調用多次分賬請求進行分賬。分賬過程中的注意事項如下:
-
一次分賬請求中,有任意一個收入方分賬失敗,則這次分賬請求的全部分賬處理均會失敗。
-
分賬請求需明確分賬的收入方,具體分賬接受的金額,分賬收入方只支持支付寶賬戶。
-
分賬金額只能按金額傳入,不支持按比率分賬。
-
分賬金額的計算公式為:可分賬金額 = 訂單金額 * 分賬比例 - 已分出金額。
注意:分賬收入方只支持支付寶賬戶,由于分賬接口與其他產品共用,接口文檔中的?trans_in?參數描述中的 cardAliasNo 類型不能被使用。
退款退分賬開發者通過?alipay.trade.refund?進行退款、退分賬。
-
當面付產品退款時不需要傳入退分賬明細;系統自動按退款金額與訂單金額的比率,從收款方和分賬收入方退款,不支持指定退款金額與退款方。
-
電腦網站支付,手機 APP 支付,手機網站支付產品,必須在退款請求中明確是否退分賬,從哪個分賬收入方退,退多少分賬金額;如不明確,默認從收款方退款,收款方余額不足退款失敗。不支持系統按比率退款。
開發者可以通過?alipay.trade.query?進行交易分賬明細查詢。
需在分賬查詢請求中通過?query_options 屬性明確指定是否需要查詢分賬明細,分賬明細主要包括分賬對手方賬號、分賬金額、分賬時間、分賬請求流水號。
API 列表以下列表包含該產品所涉及的所有接口,點擊接口英文名可查看接口的公共請求參數,業務請求參數,返回參數,其他語言請求示例以及錯誤碼等。?
分賬關系維護
接口英文名 |
接口中文名 | 描述 |
alipay.trade.royalty.relation.bind |
分賬關系綁定 |
當商家簽約分賬產品后,授權 ISV 幫其進行分賬關系的維護。本接口用于商家與分賬方的關系綁定。 |
alipay.trade.royalty.relation.unbind |
分賬關系解綁 |
當商家簽約分賬產品后,授權 ISV 幫其進行分賬關系的維護。本接口用于商家與分賬方的關系解綁。 |
alipay.trade.royalty.relation.batchquery |
分賬關系查詢 |
當商家簽約分賬產品后,授權 ISV 幫其進行分賬關系的維護。本接口用于商家與分賬方的關系查詢。 |
接口英文名 |
接口中文名 | 描述 |
alipay.trade.order.settle |
統一收單交易結算接口 |
用于在線下場景交易支付后,進行賣家與第三方(如供應商或平臺商)基于交易金額的分傭結算。 |
接口英文名 |
接口中文名 | 描述 |
alipay.trade.query |
統一收單線下交易查詢接口 |
用于賣家與第三方(如供應商或平臺商)基于交易金額的已分傭明細查詢。通過傳遞 "query_options":["TRADE_SETTE_INFO"] 參數查詢分賬明細。 |
接口英文名 |
接口中文名 | 描述 |
alipay.trade.refund |
統一收單交易退款接口 |
用于賣家賣家與第三方(如供應商或平臺商)基于交易金額的退分傭信息。通過 refund_royalty_parameters 傳遞退分傭信息。 |
常見問題Q:商家與分賬方綁定分賬關系有數量限制嗎?
A:有,最多支持建立 5000 個分賬關系。
相關推薦
- 支付寶小程序:入駐開放平臺 支付寶小程序是一種全新的開放模式,它運行在支付寶客戶端,是手機應用嵌入支付寶客戶端的一種方法。支付寶小程序開放給開發者更多的 JSAPI 和 OpenAPI,也可以提供給用戶多樣化的便捷服務。支付寶小程序可以被便捷地獲取和傳播,從而為終端用戶提供更優的用戶…
- Qt加載XPM圖像 XPM是一種基于ASCII編碼的圖像格式,一般用于創建圖標。由于它是ASCII編碼,很方便地在代碼中使用。 Qt的QPixmap類支持XPM格式,原型如下:QPixmap::QPixmap(const char *const [] xpm)摘取Qt源碼中的"嚴重警告"XPM圖標:static const char* const c…