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

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

© 2026 KukoPay. All rights reserved.

产品

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

开发者

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

公司

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

开始

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

对接指南

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

资金

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

API 参考

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

接口约定

列表、分页与导出metadata错误码
开发者文档
资金流水

资金流水

余额的每一笔变动明细,做每日对账最合适的口径。

GET /api/v1/balance_transactions

余额接口 回答余额是多少,这个接口回答它是怎么变成这样的。手续费、退款、拒付、提现各记一行,加起来就是余额的变化。

筛选参数

除 通用列表参数 外:

参数说明
type变动类型,见下表
reference_id触发这笔流水的订单号 / 退款号 / 拒付号 / 提现号
currency三位 ISO 4217 代码

变动类型

type含义金额方向
payment_credit收单入账(订单原始金额)+
fee_debit平台收单手续费−
refund_freeze退款受理,资金转入冻结−
refund_debit通道确认退款,真实扣账−
refund_unfreeze退款被拒,冻结资金退回+
dispute_freeze拒付开案,争议金额冻结−
dispute_unfreeze拒付胜诉或被撤销,冻结资金退回+
dispute_debit拒付败诉,争议金额扣账−
dispute_fee拒付处理费−
payout_freeze发起提现,金额冻结−
payout_unfreeze提现驳回或失败,冻结资金退回+
payout_success提现转账完成,从冻结中扣账−
payout_fee提现手续费−

一笔成功支付会产生两行:payment_credit(订单全额)加 fee_debit(手续费),差额就是入账净额。

请求

curl -G "https://web.kukopay.com/api/v1/balance_transactions" \
  -H "X-Api-Key: kuko_live_你的密钥" \
  -d limit=100 \
  -d "created[gte]=2026-09-20T00:00:00Z"

响应

{
  "object": "balance_transaction",
  "id": "LED_8f2c4a1e-...-CRT",
  "merchant_id": "mch_a1b2c3d4e5",
  "type": "payment_credit",
  "currency": "USD",
  "amount": 2990,
  "balance_before": 120000,
  "balance_after": 122990,
  "reference_id": "TRD_9F3A2C7E...",
  "description": "收单交易入账: Pro 年度订阅 (外单号: ORD_20260921_0001)",
  "mode": "live",
  "created_at": "2026-09-21T08:31:12.114Z"
}

balance_before / balance_after 记录的是可用余额。冻结类变动(refund_freeze、dispute_freeze、payout_freeze)会让可用余额下降、冻结余额上升;从冻结中扣账时可用余额不变,所以这两个值相等。

ℹ️

amount 是有符号整数,支出为负。把某段时间的所有 amount 相加,结果就等于这段时间可用余额的净变化。

CSV 导出

curl -G "https://web.kukopay.com/api/v1/balance_transactions" \
  -H "X-Api-Key: kuko_live_你的密钥" \
  -d format=csv \
  -d "created[gte]=2026-09-01T00:00:00Z" \
  -d "created[lte]=2026-09-30T23:59:59Z" \
  -o 2026-09-对账.csv
余额查询事件