使用 KukoPay 交易号或商户订单号查询订单状态。
GET https://web.kukopay.com/api/v1/orders/{trade_no}
路径参数同时接受平台的 trade_no 和商户自己的 out_trade_no。
curl "https://web.kukopay.com/api/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",
"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。支付成功后才有值 |
refundable_until | 最晚可退款时间。只有部分支付方式有期限（如支付宝、微信支付），没有期限时为 null |
订单只对创建它的商户与环境可见。测试密钥无法查询正式订单，反之亦然。