> ## Documentation Index
> Fetch the complete documentation index at: https://docs.killb.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 预充值账户

> 使用预存流动性的即时交易执行

## 什么是预充值账户？

预充值账户是**余额账户**，允许您与 KillB 保持流动性以进行即时交易执行。无需等待用户支付，交易会立即从您预存的资金中执行。

<Info>
  预充值非常适合需要即时结算和更好汇率的高交易量企业。
</Info>

## 工作原理

<Steps>
  <Step title="创建预充值账户">
    向 KillB 请求专用钱包或账户

    ```bash theme={null}
    POST /api/v2/customers/pre-fund/create
    ```
  </Step>

  <Step title="存入资金">
    将 USDC/USDT 转移到您的专用预充值地址

    **支持的网络：**

    * Polygon
    * Ethereum
    * Arbitrum
    * Base
  </Step>

  <Step title="在交易中使用">
    创建报价时指定预充值方式

    ```json theme={null}
    {
      "fromCurrency": "USDC",
      "toCurrency": "COP",
      "amount": 1000,
      "cashInMethod": "PRE_FUND_POLYGON",
      "cashOutMethod": "PSE"
    }
    ```
  </Step>

  <Step title="即时执行">
    交易立即执行，无需等待支付

    ⚡ 资金立即从您的余额中扣除
  </Step>
</Steps>

## 预充值方式

| 方式                  | 资产        | 网络       | 描述    |
| ------------------- | --------- | -------- | ----- |
| `PRE_FUND_POLYGON`  | USDC/USDT | Polygon  | 最低费用  |
| `PRE_FUND_ETHEREUM` | USDC/USDT | Ethereum | 最常见   |
| `PRE_FUND_ARBITRUM` | USDC/USDT | Arbitrum | 低费用   |
| `PRE_FUND_BASE`     | USDC/USDT | Base     | 新，低费用 |
| `PRE_FUND_SOLANA`   | USDC      | Solana   | 快速，便宜 |

<Tip>
  **推荐：** 使用 `PRE_FUND_POLYGON` 获得最低的网络费用和最快的处理。
</Tip>

## 优势

<CardGroup cols={2}>
  <Card title="即时执行" icon="bolt">
    无需等待用户支付 - 交易立即执行
  </Card>

  <Card title="更好的汇率" icon="chart-line">
    基于交易量的定价和优惠汇率
  </Card>

  <Card title="简化流程" icon="route">
    跳过支付收集步骤 - 直接执行
  </Card>

  <Card title="可预测的结算" icon="clock">
    准确知道交易何时完成
  </Card>

  <Card title="批量操作" icon="layer-group">
    高效处理高交易量
  </Card>

  <Card title="轻松对账" icon="calculator">
    单一余额跟踪所有交易
  </Card>
</CardGroup>

## 用例

### 高交易量企业

<Tabs>
  <Tab title="交易所平台">
    **场景：** 加密货币交易所每天需要处理 1000+ off-ramps

    **没有预充值：**

    * 等待每个用户发送加密货币
    * 监控 1000+ 个单独存款
    * 复杂的对账

    **使用预充值：**

    * 维护流动性池
    * 立即执行所有交易
    * 简单的余额跟踪
  </Tab>

  <Tab title="支付处理器">
    **场景：** 支付网关为商户将加密货币转换为法币

    **没有预充值：**

    * 等待每次支付
    * 不可预测的时间
    * 复杂的跟踪

    **使用预充值：**

    * 即时商户支付
    * 可预测的操作
    * 更好的商户体验
  </Tab>

  <Tab title="汇款服务">
    **场景：** 汇款服务向拉丁美洲发送资金

    **没有预充值：**

    * 等待发送方支付
    * 延迟的收款人交付
    * 用户体验差

    **使用预充值：**

    * 即时收款人交付
    * 更好的汇率
    * 更高的客户满意度
  </Tab>
</Tabs>

## 设置预充值

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

联系 KillB 启用预充值：

```bash theme={null}
POST /api/v2/customers/pre-fund/create
Content-Type: application/json
Authorization: Bearer YOUR_TOKEN

{
  "currency": "USDC",
  "network": "POLYGON"
}
```

**响应：**

```json theme={null}
{
  "preFundAccountId": "pf-abc123",
  "depositAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
  "network": "POLYGON",
  "currency": "USDC",
  "status": "ACTIVE"
}
```

### 步骤 2：存入初始资金

将 USDC/USDT 发送到提供的存款地址：

```bash theme={null}
# 最低初始存款：$10,000 USD 等值
# 推荐：$50,000+ 以获得最佳操作
```

<Warning>
  始终发送到正确的网络！发送到错误的网络 = 资金丢失。
</Warning>

### 步骤 3：监控余额

检查您的预充值余额：

```bash theme={null}
GET /api/v2/customers/balances
```

**响应：**

```json theme={null}
{
  "balances": [
    {
      "currency": "USDC",
      "network": "POLYGON",
      "available": "50000.00",
      "pending": "5000.00",
      "total": "55000.00"
    }
  ]
}
```

### 步骤 4：在交易中使用

使用预充值方式创建报价：

```json theme={null}
{
  "fromCurrency": "USDC",
  "toCurrency": "COP",
  "amount": 1000,
  "amountIsToCurrency": false,
  "cashInMethod": "PRE_FUND_POLYGON",
  "cashOutMethod": "PSE"
}
```

## 余额管理

### 检查余额

```bash theme={null}
GET /api/v2/customers/balances
```

### 充值余额

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

### 低余额警报

设置 webhooks 以在余额低时接收警报：

```json theme={null}
{
  "event": "balance.low",
  "data": {
    "currency": "USDC",
    "network": "POLYGON",
    "balance": "5000.00",
    "threshold": "10000.00"
  }
}
```

<Tip>
  设置低余额警报以避免因余额不足而导致的交易失败。
</Tip>

## 使用预充值的交易流程

<Steps>
  <Step title="创建报价">
    指定 `PRE_FUND_*` 作为 cashInMethod

    ```json theme={null}
    {
      "cashInMethod": "PRE_FUND_POLYGON",
      "fromCurrency": "USDC",
      "toCurrency": "COP",
      "amount": 1000
    }
    ```
  </Step>

  <Step title="创建 Ramp">
    使用报价创建 ramp

    ```json theme={null}
    {
      "quotationId": "quot-abc123",
      "userId": "user-123",
      "accountId": "acc-456"
    }
    ```
  </Step>

  <Step title="即时执行">
    ✅ 资金立即从预充值余额中扣除

    ✅ 交易无需等待即可处理

    ✅ 法币发送到用户银行账户
  </Step>

  <Step title="余额更新">
    您的余额减少交易金额 + 费用
  </Step>
</Steps>

## 定价和费用

预充值账户获得优惠定价：

| 交易量（每月）       | 费用折扣    | 汇率改善      |
| ------------- | ------- | --------- |
| $100K - $500K | 0.1% 减少 | 标准汇率      |
| $500K - $1M   | 0.2% 减少 | 0.05% 更好  |
| $1M - $5M     | 0.3% 减少 | 0.10% 更好  |
| \$5M+         | 自定义定价   | 0.15%+ 更好 |

<Info>
  联系 [sales@killb.com](mailto:sales@killb.com) 了解企业交易量定价。
</Info>

## 对账

预充值账户简化对账：

### 每日对账

```bash theme={null}
GET /api/v2/customers/transactions?startDate=2025-01-08&endDate=2025-01-08
```

**跟踪：**

* 期初余额
* 存款（充值）
* 已执行的交易
* 收取的费用
* 期末余额

### 月度对账单

下载月度对账单，显示：

* 所有交易
* 费用明细
* 余额历史
* 税务信息

## 安全

<CardGroup cols={2}>
  <Card title="隔离账户" icon="lock">
    您的余额保存在隔离账户中
  </Card>

  <Card title="审计跟踪" icon="list">
    完整的交易历史
  </Card>

  <Card title="访问控制" icon="shield">
    余额访问的 API 密钥权限
  </Card>

  <Card title="Webhook 通知" icon="bell">
    实时余额和交易警报
  </Card>
</CardGroup>

## 流动性管理

### 最佳余额

**推荐余额：**

```
每日交易量 × 3 天 = 最佳余额

示例：
- 每日交易量：$50,000
- 推荐：$150,000 余额
```

这确保：

* 3 天的操作
* 交易量激增的缓冲
* 无交易失败

### 自动充值

在余额下降时设置自动充值：

```json theme={null}
{
  "autoTopUp": {
    "enabled": true,
    "threshold": "50000.00",
    "topUpAmount": "100000.00",
    "sourceAccount": "your-exchange-account"
  }
}
```

## 最佳实践

<AccordionGroup>
  <Accordion title="保持充足余额" icon="wallet">
    * 保持 3-5 天的运营资金
    * 设置低余额警报
    * 每天监控余额
    * 为交易量激增做计划
  </Accordion>

  <Accordion title="使用正确的网络" icon="network-wired">
    * 推荐 Polygon（最低费用）
    * 在报价中匹配网络
    * 验证存款地址
    * 首先用小额测试
  </Accordion>

  <Accordion title="密切监控" icon="eye">
    * 每天检查余额
    * 审查交易日志
    * 定期对账
    * 设置 webhooks
  </Accordion>

  <Accordion title="优化定价" icon="chart-line">
    * 可用的交易量折扣
    * 使用预充值获得更好的汇率
    * 协商自定义定价
    * 跟踪与常规定价的节省
  </Accordion>
</AccordionGroup>

## 常见问题

<AccordionGroup>
  <Accordion title="最低余额是多少？" icon="dollar-sign">
    最低初始存款通常是 \$10,000 USD 等值。推荐余额取决于您的交易量。
  </Accordion>

  <Accordion title="可以从预充值余额中提款吗？" icon="money-bill-transfer">
    可以，联系支持以请求提款。处理通常需要 1-3 个工作日。
  </Accordion>

  <Accordion title="如果余额用完会怎样？" icon="exclamation">
    如果余额不足，交易将失败。设置低余额警报以防止这种情况。
  </Accordion>

  <Accordion title="有持有费用吗？" icon="percent">
    没有持有费用。您只在执行 ramps 时支付交易费用。
  </Accordion>

  <Accordion title="可以使用多种货币吗？" icon="coins">
    可以，如果需要，为 USDC 和 USDT 维护单独的余额。
  </Accordion>
</AccordionGroup>

## 下一步

<CardGroup cols={2}>
  <Card title="联系销售" icon="phone" href="mailto:sales@killb.com">
    为您的企业开始使用预充值
  </Card>

  <Card title="流动性 API" icon="code" href="/api-reference/endpoint/customers-liquidity">
    查看流动性管理端点
  </Card>

  <Card title="余额 API" icon="wallet" href="/api-reference/endpoint/customers-balances">
    检查和管理您的余额
  </Card>

  <Card title="预充值指南" icon="book" href="/zh/guides/pre-fund/pre-fund-accounts">
    完整的实现指南
  </Card>
</CardGroup>