多個網站如何用一個商戶賬戶收款？

如果同一家企業經營着好幾個網站，比如主站商城、移動 App、第二個品牌或區域站點，通常可以用一個商戶賬戶在所有網站上收款，前提是每個網站都屬於同一家通過審核的企業。你需要的是：每個網站在該分開的地方分開（密鑰、訂單號、Webhook、買家看到的名稱），在該共用的地方共用（資質、餘額、費率、提現）。

這篇文章説明如何在 KukoPay 上用一個商戶賬戶在多個網站上收款、每個網站各自擁有什麼、哪些保持共用，以及什麼情況下第二個網站需要單獨的賬戶。

一個商戶賬戶還是多個？

只需要問一個問題：是不是同一家企業？

• 同一家企業、多個網站或品牌 → 一個賬戶，每個網站一個應用（見下文）。只需審核一次，看一份餘額，提現一次。
• 另一家公司，即另一個法律主體，或者別人的業務 → 需要它自己的賬戶。資質、餘額和提現都屬於法律主體，不能在不同公司之間共用。

賬戶下的每個網站都應該是這家通過審核的企業自己在經營的，並且銷售內容在賬戶獲批的類目之內，所有網站適用同樣的規則。賬戶的審核涵蓋哪些內容，見 KYB 驗證是什麼。

應用：一個賬戶下，每個網站一個

在 KukoPay，一個商戶賬戶最多可以有 20 個應用，每個應用對應一套接入，例如官網商城、iOS App 或第二個品牌。每個應用是一套獨立的接入，背後的賬戶是共用的。

應用沒有單獨的餘額或提現，這是有意的設計：應用是同一家企業的不同接入，而不是子商戶。

每個網站各自擁有什麼

自己的密鑰，以及自己的數據

一把密鑰屬於一個應用，只能看到這個應用的對象。網站商城的密鑰讀不到 iOS App 的訂單；查詢其他應用的訂單會返回 404，就像它不存在一樣。一個網站泄露的密鑰碰不到其他網站的數據，輪換它也只影響這一個網站，見 API 密鑰輪換。

賬戶的餘額和資金流水任何應用的密鑰都可以讀取，因為錢屬於賬戶。

自己的訂單號

out_trade_no、out_refund_no 和 Idempotency-Key 都按應用唯一。兩個網站都可以有一筆 1001 號訂單而互不衝突，不需要按網站給訂單號加前綴。

自己的 Webhook

每個應用有自己的 Webhook 端點，一筆訂單的事件會發給它所屬應用的端點（以及你在控制台設置的賬戶級端點）。商城的發貨服務器永遠不會收到 App 的事件。端點如何接收和重試事件，見 收不到支付 Webhook 回調怎麼辦。

自己的收銀台品牌

在 商戶名稱與品牌 中，每個應用都可以覆蓋賬戶的對外展示名稱、Logo 和品牌色，留空的設置沿用賬戶的。第二個品牌的買家在收銀台看到的是那個品牌，而不是你的公司名，見 託管收銀台是什麼。

如何設置第二個網站

1. 創建應用。 使用控制台側邊欄頂部的應用切換器（切換應用 → 創建應用），或者在 設置 → 應用管理 中創建，以網站命名，比如「官網商城」「iOS App」。
2. 簽發它的密鑰：選中這個應用，在 開發者 → API 密鑰 中簽發。新應用一開始沒有任何密鑰。
3. 添加它的 Webhook 端點；如果它的服務器有固定 IP，再設置 IP 白名單。
4. 設置它的品牌，如果它需要和賬戶默認的外觀不同。
5. 先在沙箱裏測試：用它的 kuko_test_ 密鑰測好，再簽發正式密鑰。測試場景見 支付測試卡號大全。

在控制台裏使用應用

應用在控制台裏是一個上下文，就像環境一樣。在切換器裏選中一個應用，屬於應用的頁面都會跟着切換：概覽的數據和最近訂單、訂單與退款、拒付、收款鏈接，以及 開發者 下的所有頁面（API 密鑰、Webhook、事件、調用日誌、易支付接入和沙箱聯調）。屬於賬戶的頁面不變：錢包、結算與提現，以及設置。

每個賬戶都有一個默認應用，控制台創建的測試訂單和沒有指定應用的收款鏈接都歸它，它不能被停用。

停用一個網站

在 設置 → 應用管理 中停用它的應用。之後它不能再創建訂單（API、易支付和收款鏈接都會返回 403 app_disabled），但已有訂單仍然可以查詢、退款和通知。任何數據都不會被刪除，之後也可以重新啓用。

保持賬戶級共用的部分

• 調用頻率限制按賬戶計算：所有應用共用同一份每分鐘配額，所以一個網站上失控的任務可能拖慢其他網站，見 API 調用頻率限制。
• 收款限額（如果賬戶設有限額）會把所有應用的訂單合併計算。
• 對賬在同一本賬上進行。每筆訂單都帶有 app_id，可以按網站拆分銷售額，但餘額和提現是一份，日常流程見 支付對賬怎麼做。

總結

• 一家企業的多個網站可以用一個商戶賬戶在所有網站上收款；另一家公司需要它自己的賬戶；
• 每個網站創建一個應用：各自擁有密鑰、數據、訂單號、Webhook、IP 白名單和可選的品牌；
• 資質、餘額、費率、限額、提現和團隊保持共用，應用沒有單獨的餘額；
• 控制台像切換環境一樣按應用切換；
• 停用應用會停止新訂單，已有訂單照常處理。