GET /v1/logs調用失敗時先查這裏，再來找我們。請求體和響應體在入庫前已經脱敏，可以直接貼給支持團隊。
篩選參數
除 通用列表參數 外：
| 參數 | 説明 |
|---|---|
request_id | 精確定位一次請求 |
status | 精確狀態碼，或 4xx / 5xx 這樣的整類 |
path | 按請求路徑精確匹配 |
error_code | 按錯誤碼過濾，取值見 錯誤碼 |
# 最近被拒絕的調用
curl -G "https://api.kukopay.com/v1/logs" \
-H "X-Api-Key: kuko_live_你的密鑰" \
-d status=4xx \
-d limit=20
# 用手上的 request_id 定位
curl -G "https://api.kukopay.com/v1/logs" \
-H "X-Api-Key: kuko_live_你的密鑰" \
-d request_id=req_9f2c1a7b4e8d0356c1ab77de90f4b215響應
{
"object": "api_log",
"request_id": "req_9f2c1a7b4e8d0356c1ab77de90f4b215",
"mode": "live",
"method": "POST",
"path": "/v1/orders",
"status": 400,
"error_code": "invalid_request",
"duration_ms": 37,
"ip": "203.0.113.24",
"user_agent": "yourshop-backend/1.4.2",
"idempotency_key": "8f14e45f-ea2a-4c6f-9d3b-1b7c2a55e901",
"request_body": {
"out_trade_no": "ORD_20260921_0001",
"amount": 29.9
},
"response_body": {
"code": 400,
"error": "invalid_request",
"param": "amount",
"message": "訂單金額必須是以最小貨幣單位（分）表示的正整數"
},
"created_at": "2026-09-21T08:31:12.114Z"
}上面這條日誌一眼就能看出問題：amount 傳了 29.9 而不是 2990。
脱敏
密鑰、令牌、卡號一類字段在入庫前就被替換成 [redacted]，任何嵌套層級都會處理。被脱敏的字段名包括 api_key、secret、client_secret、client_token、password、authorization、card、card_number、cvc 等。
超過 16 KB 的請求體只記錄一個大小標記，不會整體存下來。
保留期
30 天。超期的記錄會被自動清理，響應裏的 retention_days 字段會告訴你當前的保留天數。
日誌寫入是盡力而為且不阻塞請求——日誌出問題絕不能把一筆成功的支付變成失敗。極端情況下可能出現個別調用沒有留下日誌記錄，但這不影響交易本身。