开通正式收款需要准备的资质材料与审核流程。
沙箱不需要审核。注册后在开发者中心申请 kuko_test_ 密钥即可开始联调,先把接入跑通再走审核,是推荐的顺序。
正式收款需要通过资质审核。
| 材料 | 说明 |
|---|---|
| 公司名称与营业执照号 | 与执照完全一致 |
| 营业执照扫描件 | 清晰、在有效期内 |
| 法人姓名与证件号 | 与证件一致 |
| 法人证件正反面 | 清晰可辨 |
| 联系邮箱与电话 | 审核结果与风控通知会发到这里 |
| 经营网站地址 | 需可正常访问,且经营内容与申请类目一致 |
| 经营类目 | 决定适用费率与风控策略 |
| 预计月流水 | 用于额度评估 |
| 结算银行账户 | 提现到账账户,需与公司主体一致 |
| 状态 | 含义 |
|---|---|
pending | 已提交,等待审核 |
approved | 已通过,可以申请正式密钥 |
rejected | 未通过,audit_reason 给出原因,修正后可重新提交 |
审核通过前,用正式密钥调用任何接口都会返回 403 merchant_not_approved。
这个限制是有意的:它让测试环境的代码在结构上不可能触发真实扣款,而不是靠开发者自觉。
目前支持 USD、HKD 和 CNY。
每个币种是一个独立的钱包:订单收到哪个币种,就记入哪个币种的余额,提现也从对应币种的余额中发起,平台不做自动换汇。控制台的订单、退款、拒付、钱包和提现页面都可以按币种切换查看。
审核通过后,正式上线前请逐项确认:
在开发者中心主动申请 kuko_live_ 密钥。切换环境只需要换密钥,接口地址和请求参数完全不变。
正式订单的 notify_url 必须是可公网访问的 HTTPS 地址。平台会在下单时校验,内网地址和 HTTP 会被拒绝。
至少订阅 payment.succeeded、payment.failed、refund.succeeded、dispute.created。只订阅成功事件会让你发现不了死单和拒付。见 Webhook。
确认你的验签实现能处理多个 v1=,否则密钥轮换期间会全部验签失败。
用 资金流水 做每日对账,不要只依赖 Webhook。
如果你的服务端出口 IP 固定,在开发者中心填上白名单能显著降低密钥泄漏后的风险。