KukoPay 的所有接入方式最終都走同一套服務端 API：同樣的訂單、同樣的託管收銀台、同樣的簽名 Webhook。區別只在於代碼由誰來寫。
| 方式 | 適合 | 開發量 | 能用的能力 |
|---|---|---|---|
| 現成插件 | 已經在用下表所列系統 | 不寫代碼，填幾個配置 | 下單、收銀台、支付結果回調 |
| 易支付兼容接口 | 系統已經支持易支付（epay），比如 V2Board、SSPanel、獨角數卡 | 不寫代碼，填網關地址、商戶 ID 和密鑰 | 下單、收銀台、支付成功通知、訂單查詢 |
| 收款鏈接 | 固定金額的商品、服務、捐助，沒有自己的訂單系統 | 不寫代碼，在控制台生成鏈接 | 下單、收銀台、支付結果回調、使用次數限制 |
| API 直連 | 自研系統，或需要退款、對賬、拒付處理等完整能力 | 需要服務端開發 | 全部接口 |
不確定選哪個？先在沙箱裏試。每種方式都不需要等正式資質審核就能跑通。
現成插件
插件由 KukoPay 維護，源碼與本文檔一起發佈，下載地址都在 kukopay.com/downloads 下，每個版本都附 SHA-256 校驗值。
插件只負責「下單 → 跳轉收銀台 → 回調履約」這條主鏈路。退款、拒付舉證和提現在 商戶控制台 操作，不需要插件支持。
你用的系統不在列表裏？如果它支持易支付，直接用 易支付兼容接口；如果它能調用 HTTP 接口，照 快速接入 對接一般只需要兩個接口：統一下單 和 Webhook 驗簽。
無論哪種方式都要注意
- 以支付通知或訂單查詢為準履約。 買家瀏覽器跳回你的頁面只是用戶體驗，不代表已付款。
- 正式環境必須有地方接收回調。 要麼每筆訂單傳公網 HTTPS 的
notify_url，要麼在控制台「開發者 → Webhook」為該應用（或整個賬戶）添加訂閲了payment.succeeded的端點，否則正式環境下單會被拒絕。易支付下單時自帶notify_url，不受這條限制。 - 每套系統用一個應用。 同一個賬戶可以為不同的系統分別創建應用，各自的密鑰、訂單號和回調互不影響，資金仍在同一個賬戶裏，見 認證與環境。
- 測試憑證與正式憑證分開配置。 環境只由憑證決定：API Key 前綴
kuko_test_是沙箱、kuko_live_是正式；易支付則由pid決定。兩個環境的簽名密鑰也不同。