跳转到主要内容

​
什么是预充值账户？

预充值账户是余额账户，允许您与 KillB 保持流动性以进行即时交易执行。无需等待用户支付，交易会立即从您预存的资金中执行。
预充值非常适合需要即时结算和更好汇率的高交易量企业。

​
工作原理

1

创建预充值账户

向 KillB 请求专用钱包或账户
POST /api/v2/customers/pre-fund/create
2

存入资金

将 USDC/USDT 转移到您的专用预充值地址支持的网络：
  • Polygon
  • Ethereum
  • Arbitrum
  • Base
3

在交易中使用

创建报价时指定预充值方式
{
  "fromCurrency": "USDC",
  "toCurrency": "COP",
  "amount": 1000,
  "cashInMethod": "PRE_FUND_POLYGON",
  "cashOutMethod": "PSE"
}
4

即时执行

交易立即执行，无需等待支付⚡ 资金立即从您的余额中扣除

​
预充值方式

方式资产网络描述
PRE_FUND_POLYGONUSDC/USDTPolygon最低费用
PRE_FUND_ETHEREUMUSDC/USDTEthereum最常见
PRE_FUND_ARBITRUMUSDC/USDTArbitrum低费用
PRE_FUND_BASEUSDC/USDTBase新，低费用
PRE_FUND_SOLANAUSDCSolana快速，便宜
推荐： 使用 PRE_FUND_POLYGON 获得最低的网络费用和最快的处理。

​
优势

即时执行

无需等待用户支付 - 交易立即执行

更好的汇率

基于交易量的定价和优惠汇率

简化流程

跳过支付收集步骤 - 直接执行

可预测的结算

准确知道交易何时完成

批量操作

高效处理高交易量

轻松对账

单一余额跟踪所有交易

​
用例

​
高交易量企业

场景： 加密货币交易所每天需要处理 1000+ off-ramps没有预充值：
  • 等待每个用户发送加密货币
  • 监控 1000+ 个单独存款
  • 复杂的对账
使用预充值：
  • 维护流动性池
  • 立即执行所有交易
  • 简单的余额跟踪

​
设置预充值

​
步骤 1：请求预充值账户

联系 KillB 启用预充值： 
POST /api/v2/customers/pre-fund/create
Content-Type: application/json
Authorization: Bearer YOUR_TOKEN

{
  "currency": "USDC",
  "network": "POLYGON"
}
响应： 
{
  "preFundAccountId": "pf-abc123",
  "depositAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
  "network": "POLYGON",
  "currency": "USDC",
  "status": "ACTIVE"
}

​
步骤 2：存入初始资金

将 USDC/USDT 发送到提供的存款地址： 
# 最低初始存款：$10,000 USD 等值
# 推荐：$50,000+ 以获得最佳操作
始终发送到正确的网络！发送到错误的网络 = 资金丢失。

​
步骤 3：监控余额

检查您的预充值余额： 
GET /api/v2/customers/balances
响应： 
{
  "balances": [
    {
      "currency": "USDC",
      "network": "POLYGON",
      "available": "50000.00",
      "pending": "5000.00",
      "total": "55000.00"
    }
  ]
}

​
步骤 4：在交易中使用

使用预充值方式创建报价： 
{
  "fromCurrency": "USDC",
  "toCurrency": "COP",
  "amount": 1000,
  "amountIsToCurrency": false,
  "cashInMethod": "PRE_FUND_POLYGON",
  "cashOutMethod": "PSE"
}

​
余额管理

​
检查余额

GET /api/v2/customers/balances

​
充值余额

随时将额外的 USDC/USDT 发送到您的存款地址。

​
低余额警报

设置 webhooks 以在余额低时接收警报： 
{
  "event": "balance.low",
  "data": {
    "currency": "USDC",
    "network": "POLYGON",
    "balance": "5000.00",
    "threshold": "10000.00"
  }
}
设置低余额警报以避免因余额不足而导致的交易失败。

​
使用预充值的交易流程

1

创建报价

指定 PRE_FUND_* 作为 cashInMethod
{
  "cashInMethod": "PRE_FUND_POLYGON",
  "fromCurrency": "USDC",
  "toCurrency": "COP",
  "amount": 1000
}
2

创建 Ramp

使用报价创建 ramp
{
  "quotationId": "quot-abc123",
  "userId": "user-123",
  "accountId": "acc-456"
}
3

即时执行

✅ 资金立即从预充值余额中扣除✅ 交易无需等待即可处理✅ 法币发送到用户银行账户
4

余额更新

您的余额减少交易金额 + 费用

​
定价和费用

预充值账户获得优惠定价：
交易量（每月）费用折扣汇率改善
100K−100K - 500K0.1% 减少标准汇率
500K−500K - 1M0.2% 减少0.05% 更好
1M−1M - 5M0.3% 减少0.10% 更好
$5M+自定义定价0.15%+ 更好
联系 [email protected] 了解企业交易量定价。

​
对账

预充值账户简化对账：

​
每日对账

GET /api/v2/customers/transactions?startDate=2025-01-08&endDate=2025-01-08
跟踪：
  • 期初余额
  • 存款（充值）
  • 已执行的交易
  • 收取的费用
  • 期末余额

​
月度对账单

下载月度对账单，显示：
  • 所有交易
  • 费用明细
  • 余额历史
  • 税务信息

​
安全

隔离账户

您的余额保存在隔离账户中

审计跟踪

完整的交易历史

访问控制

余额访问的 API 密钥权限

Webhook 通知

实时余额和交易警报

​
流动性管理

​
最佳余额

推荐余额： 
每日交易量 × 3 天 = 最佳余额

示例：
- 每日交易量：$50,000
- 推荐：$150,000 余额
这确保：
  • 3 天的操作
  • 交易量激增的缓冲
  • 无交易失败

​
自动充值

在余额下降时设置自动充值： 
{
  "autoTopUp": {
    "enabled": true,
    "threshold": "50000.00",
    "topUpAmount": "100000.00",
    "sourceAccount": "your-exchange-account"
  }
}

​
最佳实践

  • 保持 3-5 天的运营资金
  • 设置低余额警报
  • 每天监控余额
  • 为交易量激增做计划
  • 推荐 Polygon（最低费用）
  • 在报价中匹配网络
  • 验证存款地址
  • 首先用小额测试
  • 每天检查余额
  • 审查交易日志
  • 定期对账
  • 设置 webhooks
  • 可用的交易量折扣
  • 使用预充值获得更好的汇率
  • 协商自定义定价
  • 跟踪与常规定价的节省

​
常见问题

最低初始存款通常是 $10,000 USD 等值。推荐余额取决于您的交易量。
可以，联系支持以请求提款。处理通常需要 1-3 个工作日。
如果余额不足，交易将失败。设置低余额警报以防止这种情况。
没有持有费用。您只在执行 ramps 时支付交易费用。
可以，如果需要，为 USDC 和 USDT 维护单独的余额。

​
下一步

联系销售

为您的企业开始使用预充值

流动性 API

查看流动性管理端点

余额 API

检查和管理您的余额

预充值指南

完整的实现指南