KukoPay 开发者文档

KukoPay 提供服务端到服务端的 HTTP + JSON API。商户通过 API 创建订单，将买家引导到托管收银台，并通过签名 Webhook 接收最终支付结果。

从这里开始

上线前务必读

API 参考

四条重要约定

1. 金额一律是整数分。 $29.90 写作 2990，不接受小数。
2. 环境由 API Key 决定。 kuko_test_ 是沙箱，kuko_live_ 是正式环境，请求体里没有环境开关。
3. 入账以异步通知为准。 不要依赖买家浏览器回跳来确认支付成功。
4. 每个响应都带 request_id。 请记进日志，它是排障时唯一能精确定位一次请求的凭据。

所有公开商户 API 都位于 https://web.kukopay.com/api/v1。router.kukopay.com 是平台内部支付引擎，不是商户接入地址。

机器可读的接口契约

完整的 OpenAPI 3.1 描述可以直接拉取，用来生成客户端、导入 Postman 或做契约测试：

curl https://web.kukopay.com/api/v1/openapi.json

这份文件由服务端代码直接生成，枚举值、限额和错误码与线上实现始终一致。