GET https://api.kukopay.com/v1/orders/{trade_no}
路徑參數同時接受平台的 trade_no 和商戶自己的 out_trade_no。
curl "https://api.kukopay.com/v1/orders/ORD_20260921_0001" \
-H "X-Api-Key: $KUKOPAY_API_KEY"{
"code": 200,
"message": "success",
"data": {
"trade_no": "TRD_SB_9F3A...",
"out_trade_no": "ORD_20260921_0001",
"amount": 2990,
"currency": "USD",
"status": "paid",
"mode": "sandbox",
"payment_method": "alipay",
"refundable_until": "2026-12-20T11:58:31.000Z",
"expires_at": "2026-09-22T11:58:31.000Z",
"paid_at": "2026-09-21T12:00:00.000Z"
}
}可能的狀態包括 pending、paid、partially_refunded、refunded、failed 和 expired。
| 字段 | 説明 |
|---|---|
payment_method | 買家實際使用的支付方式：card、alipay、wechat_pay、apple_pay、google_pay、paypal。支付成功後才有值。正式環境的收銀台只提供平台為商戶開通的方式，沙箱提供全部 |
fee_details | 手續費 fee 按哪一檔計算：fee_group（card / local_wallet / other，由 payment_method 決定）、fee_percent 比例和 fixed_fee 固定費（最小貨幣單位）。支付成功後才有值，見費率與結算 |
refundable_until | 最晚可退款時間。只有部分支付方式有期限（如支付寶、微信支付、PayPal），沒有期限時為 null |
expires_at | 收銀台鏈接失效時間（創建後 24 小時）。此後買家無法再支付，仍未支付的訂單由平台關閉為 expired 併發出 payment.expired |
查詢接口適合主動核對，但正常履約仍應由驗簽後的 Webhook 驅動。
訂單只對創建它的商戶與環境可見。測試密鑰無法查詢正式訂單，反之亦然。