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

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

© 2026 KukoPay. All rights reserved.

产品

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

开发者

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

公司

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

开始

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

对接指南

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

资金

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

API 参考

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

接口约定

列表、分页与导出metadata错误码
开发者文档
费率与结算

费率与结算

手续费如何计算、资金何时入账、余额的四个口径。

手续费

手续费 = round(订单金额 × 费率 + 固定费用)
入账净额 = 订单金额 - 手续费

默认费率 3.5% + $0.30,按商户可配,签约时确定。金额一律是整数最小货币单位(美分),不要传小数。

以一笔 $29.90 的订单为例:

amount      = 2990
fee         = round(2990 × 0.035 + 30) = 135
net_amount  = 2990 - 135 = 2855

订单对象上的 fee 和 net_amount 在支付成功入账后才有值,未支付时都是 0。

什么时候入账

支付成功即入账,没有账期。资金进入你的可用余额,可以立即用于退款或发起提现。

入账只以上游通道的确认为准。收银台页面显示成功、买家浏览器回跳,都不会直接入账——平台会向通道回读这笔支付,核对金额与币种一致后才记账。这意味着即使买家关掉了页面,钱也不会丢。

ℹ️

沙箱环境初始赠送 $5,000.00 虚拟体验金,用于联调退款与提现流程。它不是真实资金,也无法提现到银行账户。

余额的四个口径

余额接口 返回的字段含义:

字段含义
available_balance可提现余额。存在未结案拒付时可能为负
frozen_balance冻结余额:在途退款与未结案拒付占用
total_revenue累计收单金额(订单原始金额,未扣费)
total_fee累计手续费
total_refund累计退款金额
total_payout累计提现金额

available_balance 是当前状态的快照。想知道"它是怎么变成现在这样的",用 资金流水——那里每一笔变动各记一行,加起来就是余额的变化,是做每日对账最合适的口径。

退款对资金的影响

退款分两个阶段,因为通道确认退款需要时间:

  1. 受理——金额从 available 移入 frozen(refund_freeze)。钱还没退出去,但已经被锁定,不能提现。
  2. 确认——通道确认后从 frozen 真实扣账(refund_debit);通道拒绝则解冻退回(refund_unfreeze)。

只有真实扣账后才会推送 refund.succeeded。接口返回 202 且 status 为 pending 时,不要告诉买家钱已经退回去了。

环境隔离

沙箱与正式的余额、账本、银行账户完全独立,各自记一套。测试密钥永远看不到正式资金,反之亦然。

沙箱测试拒付与争议