创建支付订单并获取托管收银台链接。
POST https://web.kukopay.com/api/v1/orders
curl -X POST "https://web.kukopay.com/api/v1/orders" \
-H "Content-Type: application/json" \
-H "X-Api-Key: $KUKOPAY_API_KEY" \
-d '{
"out_trade_no": "ORD_20260921_0001",
"amount": 2990,
"currency": "USD",
"subject": "Premium plan",
"notify_url": "https://shop.example.com/webhooks/kukopay",
"return_url": "https://shop.example.com/orders/complete"
}'| 字段 | 必填 | 说明 |
|---|---|---|
out_trade_no | 否 | 商户订单号，也是幂等键；不传则自动生成 |
amount | 是 | 最小货币单位的正整数，2990 表示 $29.90 |
currency | 否 | USD、HKD 或 CNY，默认 USD。沙箱可用全部三种；正式环境只能用平台为你开通的币种，未开通时返回 400 invalid_request |
subject | 否 | 商品标题，最长 255 字符 |
notify_url | 正式必填 | 接收异步通知的公网 HTTPS 地址 |
return_url | 否 | 支付完成后买家浏览器回跳地址 |
首次创建返回 HTTP 201，幂等命中返回 HTTP 200：
{
"code": 200,
"message": "下单成功",
"data": {
"trade_no": "TRD_SB_9F3A...",
"out_trade_no": "ORD_20260921_0001",
"amount": 2990,
"currency": "USD",
"status": "pending",
"mode": "sandbox",
"checkout_url": "https://web.kukopay.com/checkout?trade_no=TRD_SB_9F3A...&token=..."
}
}把买家重定向到 checkout_url。URL 中包含短期 bearer token，不要把完整地址记录到第三方分析平台或公开日志。