KukoPay 提供服務端到服務端的 HTTP + JSON API。商戶通過 API 創建訂單，將買家引導到託管收銀台，並通過簽名 Webhook 接收最終支付結果。
第一次接入？直接閲讀快速接入，在沙箱環境跑通第一筆完整支付。申請測試密鑰不需要等待正式資質審核。
已經在用 Xboard 這類現成系統？先看選擇接入方式：裝插件、填幾個配置就能收款，不需要寫代碼。
從這裏開始
上線前務必讀
API 參考
四條重要約定
- 金額一律是整數分。
$29.90寫作2990，不接受小數。 - 環境由 API Key 決定。
kuko_test_是沙箱，kuko_live_是正式環境，請求體裏沒有環境開關。 - 入賬以異步通知為準。 不要依賴買家瀏覽器回跳來確認支付成功。
- 每個響應都帶
request_id。 請記進日誌，它是排障時唯一能精確定位一次請求的憑據。
所有公開商戶 API 都位於 https://api.kukopay.com/v1。router.kukopay.com 是平台內部支付引擎，不是商戶接入地址。
機器可讀的接口契約
完整的 OpenAPI 3.1 描述可以直接拉取，用來生成客戶端、導入 Postman 或做契約測試：
curl https://api.kukopay.com/v1/openapi.json這份文件由服務端代碼直接生成，枚舉值、限額和錯誤碼與線上實現始終一致。