沙箱不涉及真實資金。主動申請測試密鑰後即可開始，無需等待資質審核。
註冊並取得測試密鑰
前往 KukoPay 商戶後台 註冊。登錄後打開「開發者 → API 密鑰」，在默認應用下（也可以先用左上角的應用切換器為這套接入新建一個應用）簽發一把以 kuko_test_ 開頭的沙箱 API Key。
配置沙箱 Webhook 端點
在「開發者 → Webhook」為該應用添加可從公網訪問的 HTTPS 地址，訂閲 payment.succeeded、payment.failed 和 payment.expired，並保存該端點的簽名密鑰。暫時沒有公網地址時，可以先用訂單查詢和事件接口聯調，再補做回調驗簽與失敗重投。
創建一筆訂單
curl -X POST "https://api.kukopay.com/v1/orders" \
-H "Content-Type: application/json" \
-H "X-Api-Key: kuko_test_你的測試密鑰" \
-d '{
"out_trade_no": "ORD_20260921_0001",
"amount": 2990,
"currency": "USD",
"subject": "測試商品"
}'成功後返回 KukoPay 交易號和託管收銀台地址：
{
"code": 201,
"message": "下單成功",
"data": {
"trade_no": "TRD_SB_9F3A2C7E...",
"out_trade_no": "ORD_20260921_0001",
"amount": 2990,
"currency": "USD",
"status": "pending",
"mode": "sandbox",
"checkout_url": "https://checkout.kukopay.com/checkout?trade_no=TRD_SB_9F3A...&token=..."
}
}把買家引導到收銀台
將買家瀏覽器重定向到 checkout_url。這個 URL 含有短期訪問令牌，不要寫入公開日誌、埋點參數或自行修改查詢參數。
接收異步通知
支付成功後，KukoPay 會向已啓用且訂閲該事件的沙箱端點推送 payment.succeeded。如果下單時顯式傳了 notify_url，則使用該訂單級地址。請先完成 Webhook 驗簽，再發貨或開通服務。
主動查詢訂單
curl "https://api.kukopay.com/v1/orders/ORD_20260921_0001" \
-H "X-Api-Key: kuko_test_你的測試密鑰"切換到正式環境
沙箱跑通後，需要完成商戶資質審核並申請 kuko_live_ 密鑰。接口地址和請求參數不變，只替換密鑰；正式訂單需有已啓用且訂閲 payment.succeeded 的正式環境 Webhook 端點，或在訂單中顯式傳公網 HTTPS notify_url。
請求體裏沒有 mode 或 environment 開關。環境只由 API Key 前綴決定，避免測試代碼誤觸發真實扣款。