KukoPay
  • 产品能力
  • 快速接入
  • API 参考
  • 商户后台
KukoPay

面向出海业务的一站式支付基础设施。通过一套服务端 API 接入托管收银台、订单、退款、Webhook、钱包与提现。

© 2026 KukoPay. All rights reserved.

产品

  • 产品能力
  • 接入流程
  • 安全设计
  • 商户后台

开发者

  • 文档首页
  • 快速接入
  • 统一下单 API
  • Webhook

公司

  • 联系我们
  • 服务条款
  • 隐私政策
  • 可接受使用政策

开始

文档首页快速接入商户入驻与审核认证与环境支付流程

对接指南

异步通知 Webhook幂等与重试沙箱测试

资金

费率与结算拒付与争议提现出金

API 参考

统一下单订单查询申请退款拒付收款链接余额查询资金流水事件Webhook 端点API 调用日志

接口约定

列表、分页与导出metadata错误码
开发者文档
商户入驻与审核

商户入驻与审核

开通正式收款需要准备的资质材料与审核流程。

沙箱不需要审核。注册后在开发者中心申请 kuko_test_ 密钥即可开始联调,先把接入跑通再走审核,是推荐的顺序。

正式收款需要通过资质审核。

需要准备的材料

材料说明
公司名称与营业执照号与执照完全一致
营业执照扫描件清晰、在有效期内
法人姓名与证件号与证件一致
法人证件正反面清晰可辨
联系邮箱与电话审核结果与风控通知会发到这里
经营网站地址需可正常访问,且经营内容与申请类目一致
经营类目决定适用费率与风控策略
预计月流水用于额度评估
结算银行账户提现到账账户,需与公司主体一致

审核状态

状态含义
pending已提交,等待审核
approved已通过,可以申请正式密钥
rejected未通过,audit_reason 给出原因,修正后可重新提交

审核通过前,用正式密钥调用任何接口都会返回 403 merchant_not_approved。

ℹ️

这个限制是有意的:它让测试环境的代码在结构上不可能触发真实扣款,而不是靠开发者自觉。

收款币种

目前支持 USD、HKD 和 CNY。

  • 沙箱:三种币种都可以直接下单,用来在开通前测试。
  • 正式环境:只能用平台在审核时为你开通的币种创建订单和收款链接。需要增加币种时请联系平台。

每个币种是一个独立的钱包:订单收到哪个币种,就记入哪个币种的余额,提现也从对应币种的余额中发起,平台不做自动换汇。控制台的订单、退款、拒付、钱包和提现页面都可以按币种切换查看。

上线检查清单

审核通过后,正式上线前请逐项确认:

申请正式密钥

在开发者中心主动申请 kuko_live_ 密钥。切换环境只需要换密钥,接口地址和请求参数完全不变。

配置 notify_url

正式订单的 notify_url 必须是可公网访问的 HTTPS 地址。平台会在下单时校验,内网地址和 HTTP 会被拒绝。

配置 Webhook 端点并订阅失败事件

至少订阅 payment.succeeded、payment.failed、refund.succeeded、dispute.created。只订阅成功事件会让你发现不了死单和拒付。见 Webhook。

核对验签代码

确认你的验签实现能处理多个 v1=,否则密钥轮换期间会全部验签失败。

接上对账

用 资金流水 做每日对账,不要只依赖 Webhook。

配置 IP 白名单(可选)

如果你的服务端出口 IP 固定,在开发者中心填上白名单能显著降低密钥泄漏后的风险。

快速接入认证与环境