統一支付 API
使用 HTTP + JSON 創建訂單、查詢狀態和發起退款。接口契約清晰，易於接入。
訂單進來，資金到賬。
Fig. 1示意數據，非真實交易量
- 統一接口
- HTTP + JSON
- 適配現有服務端
- 測試與正式隔離
- 雙環境
- 由密鑰前綴明確區分
- 通知驗簽
- HMAC-SHA256
- 可信的異步事件
- 未決交易對賬
- 自動補償
- 持續核驗最終狀態
- 免費沙箱聯調
- 託管收銀台
- 可驗證的 Webhook
01平台能力
一條完整的支付鏈路
把必要能力放在同一套接口中，每個狀態都可查詢、每筆資金都可追蹤。
託管收銀台
通過簽名鏈接將買家帶到收銀台，無需在你的系統中處理支付憑據。
環境隔離
測試與正式密鑰獨立，降低聯調期間誤觸發真實交易的風險。
可靠通知
Webhook 支持簽名驗證、失敗重投、投遞記錄和手動重發。
自動對賬
持續核對未決支付與退款，在通知缺失時再次確認最終結果。
錢包與賬本
入賬、退款和提現對應可追蹤的流水，讓餘額變化有據可查。
02支付方式與費率
能收哪些款，收費多少
以下為平台標準條款。審核通過的商戶可以在商戶後台查看自己簽約的費率。
- 支付方式
- 銀行卡
- Apple Pay
- Google Pay
- 支付寶
- 微信支付
- PayPal
- 沙箱提供全部方式；正式環境的支付方式在審核時按商戶開通，之後可在後台申請更多。
- 收款幣種
- USD · HKD · CNY
- 每個幣種是獨立的錢包，按原幣種提現，平台不做自動換匯。
- 標準費率
- 3.5% + 固定費
- 按每筆成功支付收取，固定費為 $0.30 · HK$2.35 · ¥2.00。手續費不會超過訂單金額。
03為開發者而設計
一個請求，創建第一筆支付
服務端創建訂單後，將買家跳轉到返回的收銀台地址。商戶訂單號同時作為冪等鍵，超時後可以安全重試。
請求
curl -X POST https://api.kukopay.com/v1/orders \
-H "X-Api-Key: kuko_test_•••" \
-H "Content-Type: application/json" \
-d '{
"out_trade_no": "ORD_2026_001",
"amount": 2990,
"currency": "USD",
"subject": "Premium plan"
}'響應 201
{
"code": 201,
"data": {
"trade_no": "TRD_SB_9F3A2C7E…",
"status": "pending",
"checkout_url": "https://checkout.kukopay.com/…"
}
}訂單金額
$29.90 USD
ORD_2026_001
沙箱已支付
支付全流程
- 創建訂單
POST /v1/orders - 買家進入收銀台
checkout_url - 支付成功
payment.succeeded - Webhook 已送達
HTTP 200 - 記入錢包流水
+ $29.90
Fig. 2示意界面，非真實交易
查看快速接入04接入方式
按你的系統，選最短的接入路徑
所有方式都生成同樣的訂單、使用同一個託管收銀台，結算和通知完全一致，區別只在於代碼由誰來寫。
05接入流程
四步完成支付閉環
瀏覽器回跳負責體驗；經服務端驗簽的通知才是履約依據。
- 01
獲取沙箱密鑰
註冊商戶後申請測試密鑰，立即開始聯調。
- 02
創建支付訂單
發送金額、訂單號和通知地址，取得託管收銀台鏈接。
- 03
買家完成付款
將買家跳轉到收銀台，由 KukoPay 承接支付流程。
- 04
驗簽通知並履約
驗證 payment.succeeded 事件，並按事件 ID 去重。
06安全設計
安全邊界，內置於流程
通過環境隔離、簽名校驗和賬本約束，減少依賴人工記憶的操作風險。
密鑰保護
密鑰加密保存，並支持商戶主動重置。
來源控制
商戶級 API 限流與可選 IP 白名單。
環境隔離
測試和正式環境使用獨立密鑰與賬本。
資金一致性
餘額變更與冪等狀態轉換均有對應流水。
07常見問題
接入前，你可能想了解
KukoPay 是什麼？
KukoPay 是面向跨境業務的支付網關。你的服務端調用一個接口創建訂單，把買家帶到 KukoPay 託管收銀台付款；平台向支付通道確認結果後，把淨額記入對應幣種的錢包，並用簽名 Webhook 通知你。退款、拒付、對賬和提現也通過同一套 API 與商戶後台完成。
支持哪些支付方式和幣種？
平台支持銀行卡、Apple Pay、Google Pay、支付寶、微信支付和 PayPal，收款幣種為 USD、HKD 和 CNY。沙箱可以直接使用全部方式；正式環境的支付方式和幣種在審核時按商戶開通，之後可以在後台申請更多。每個幣種是獨立的錢包，平台不做自動換匯。
KukoPay 怎麼收費？
標準費率為每筆成功支付 3.5% 加固定費：USD 訂單 $0.30、HKD 訂單 HK$2.35、CNY 訂單 ¥2.00，手續費不會超過訂單金額。簽約時可以按支付渠道單獨商定費率，每筆訂單都會記錄實際適用的費率。沙箱免費使用。
沒有營業執照可以開通嗎？
可以。除中國大陸公司、個體工商戶和境外公司外，年滿 18 週歲的個人也可以憑本人證件開通。個人商戶有收款限額，只能提現到本人名下的個人賬戶，並且不能經營數字商品和網絡遊戲類目。
不寫代碼可以收款嗎？
可以。收款鏈接不需要寫代碼；已對接常見支付協議的系統填入網關地址和密鑰即可；支持的平台還有現成插件。退款、對賬和拒付舉證可以在商戶後台完成。
在哪裏查看開發文檔？
公開接入文檔位於 kukopay.com/docs；密鑰、訂單和 Webhook 投遞記錄位於商戶後台。
如何避免重複下單或重複發貨？
創建訂單時使用唯一的 out_trade_no；處理 Webhook 時按事件 ID 去重。網絡超時後可重試同一訂單號。
瀏覽器回跳能作為支付成功依據嗎？
不能。請以驗簽後的 payment.succeeded Webhook 為履約依據，並用訂單查詢接口補充核驗。