> ## 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.

# Cuentas Pre-Fondeadas

> Ejecución instantánea de transacciones con liquidez pre-depositada

## ¿Qué son las Cuentas Pre-Fondeadas?

Las cuentas pre-fondeadas son **cuentas de saldo** que te permiten mantener liquidez con KillB para ejecución instantánea de transacciones. En lugar de esperar los pagos de los usuarios, las transacciones se ejecutan inmediatamente desde tus fondos pre-depositados.

<Info>
  El pre-fondeo es ideal para empresas con alto volumen de transacciones que necesitan liquidaciones instantáneas y mejores tasas.
</Info>

## Cómo Funciona

<Steps>
  <Step title="Crear Cuenta Pre-Fondeada">
    Solicita una billetera o cuenta dedicada de KillB

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

  <Step title="Depositar Fondos">
    Transfiere USDC/USDT a tu dirección de pre-fondeo dedicada

    **Redes Soportadas:**

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

  <Step title="Usar en Transacciones">
    Especifica método de pre-fondeo al crear cotizaciones

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

  <Step title="Ejecución Instantánea">
    Transacciones ejecutan inmediatamente sin esperar por pago

    ⚡ Fondos deducidos de tu saldo instantáneamente
  </Step>
</Steps>

## Métodos de Pre-Fondeo

| Método              | Activo    | Red      | Descripción          |
| ------------------- | --------- | -------- | -------------------- |
| `PRE_FUND_POLYGON`  | USDC/USDT | Polygon  | Tarifas más bajas    |
| `PRE_FUND_ETHEREUM` | USDC/USDT | Ethereum | Más común            |
| `PRE_FUND_ARBITRUM` | USDC/USDT | Arbitrum | Tarifas bajas        |
| `PRE_FUND_BASE`     | USDC/USDT | Base     | Nuevo, tarifas bajas |
| `PRE_FUND_SOLANA`   | USDC      | Solana   | Rápido, barato       |

<Tip>
  **Recomendado:** Usa `PRE_FUND_POLYGON` para las tarifas de red más bajas y procesamiento más rápido.
</Tip>

## Beneficios

<CardGroup cols={2}>
  <Card title="Ejecución Instantánea" icon="bolt">
    Sin espera por pagos del usuario - transacciones ejecutan inmediatamente
  </Card>

  <Card title="Mejores Tasas" icon="chart-line">
    Precios basados en volumen con tasas de cambio preferenciales
  </Card>

  <Card title="Flujo Simplificado" icon="route">
    Salta el paso de cobro de pago - ejecución directa
  </Card>

  <Card title="Liquidación Predecible" icon="clock">
    Sabe exactamente cuándo se completarán las transacciones
  </Card>

  <Card title="Operaciones en Masa" icon="layer-group">
    Procesa altos volúmenes eficientemente
  </Card>

  <Card title="Reconciliación Fácil" icon="calculator">
    Saldo único para rastrear todas las transacciones
  </Card>
</CardGroup>

## Casos de Uso

### Empresas de Alto Volumen

<Tabs>
  <Tab title="Plataforma de Exchange">
    **Escenario:** Exchange cripto necesita procesar 1000+ off-ramps diariamente

    **Sin Pre-Fondeo:**

    * Esperar que cada usuario envíe cripto
    * Monitorear 1000+ depósitos individuales
    * Reconciliación compleja

    **Con Pre-Fondeo:**

    * Mantener pool de liquidez
    * Ejecutar todas las transacciones instantáneamente
    * Seguimiento simple de saldo
  </Tab>

  <Tab title="Procesador de Pagos">
    **Escenario:** Gateway de pago convirtiendo cripto a fiat para comerciantes

    **Sin Pre-Fondeo:**

    * Esperar por cada pago
    * Tiempo impredecible
    * Seguimiento complejo

    **Con Pre-Fondeo:**

    * Pagos instantáneos a comerciantes
    * Operaciones predecibles
    * Mejor experiencia del comerciante
  </Tab>

  <Tab title="Servicio de Remesas">
    **Escenario:** Servicio de transferencia de dinero enviando fondos a América Latina

    **Sin Pre-Fondeo:**

    * Esperar pago del remitente
    * Entrega retrasada al destinatario
    * Mala experiencia del usuario

    **Con Pre-Fondeo:**

    * Entrega instantánea al destinatario
    * Mejores tasas de cambio
    * Mayor satisfacción del cliente
  </Tab>
</Tabs>

## Configurando Pre-Fondeo

### Paso 1: Solicitar Cuenta Pre-Fondeada

Contacta a KillB para habilitar pre-fondeo:

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

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

**Respuesta:**

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

### Paso 2: Depositar Fondos Iniciales

Envía USDC/USDT a la dirección de depósito proporcionada:

```bash theme={null}
# Depósito inicial mínimo: $10.000 USD equivalente
# Recomendado: $50.000+ para operaciones optimizadas
```

<Warning>
  ¡Siempre envía a la red correcta! Enviar a red equivocada = fondos perdidos.
</Warning>

### Paso 3: Monitorear Saldo

Verifica tu saldo pre-fondeado:

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

**Respuesta:**

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

### Paso 4: Usar en Transacciones

Crea cotizaciones usando método de pre-fondeo:

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

## Gestión de Saldo

### Verificar Saldo

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

### Recargar Saldo

Envía USDC/USDT adicional a tu dirección de depósito en cualquier momento.

### Alertas de Saldo Bajo

Configura webhooks para recibir alertas cuando el saldo esté bajo:

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

<Tip>
  Configura alertas de saldo bajo para evitar fallas de transacción debido a fondos insuficientes.
</Tip>

## Flujo de Transacción con Pre-Fondeo

<Steps>
  <Step title="Crear Cotización">
    Especifica `PRE_FUND_*` como cashInMethod

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

  <Step title="Crear Ramp">
    Usa cotización para crear ramp

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

  <Step title="Ejecución Instantánea">
    ✅ Fondos inmediatamente deducidos del saldo pre-fondeado

    ✅ Transacción procesa sin espera

    ✅ Fiat enviado a cuenta bancaria del usuario
  </Step>

  <Step title="Saldo Actualizado">
    Tu saldo disminuye por el monto de la transacción + tarifas
  </Step>
</Steps>

## Precios y Tarifas

Las cuentas pre-fondeadas reciben precios preferenciales:

| Volumen de Transacción (Mensual) | Descuento de Tarifa    | Mejora en Tasa de Cambio |
| -------------------------------- | ---------------------- | ------------------------ |
| $100K - $500K                    | Reducción de 0,1%      | Tasa estándar            |
| $500K - $1M                      | Reducción de 0,2%      | 0,05% mejor              |
| $1M - $5M                        | Reducción de 0,3%      | 0,10% mejor              |
| \$5M+                            | Precios personalizados | 0,15%+ mejor             |

<Info>
  Contacta a [sales@killb.com](mailto:sales@killb.com) para precios de volumen empresarial.
</Info>

## Gestión de Liquidez

### Saldo Óptimo

**Saldo recomendado:**

```
Volumen Diario × 3 días = Saldo Óptimo

Ejemplo:
- Volumen diario: $50.000
- Recomendado: saldo de $150.000
```

Esto asegura:

* 3 días de operaciones
* Buffer para picos de volumen
* Sin fallas de transacción

## Mejores Prácticas

<AccordionGroup>
  <Accordion title="Mantener Saldo Suficiente" icon="wallet">
    * Mantén 3-5 días de capital operacional
    * Configura alertas de saldo bajo
    * Monitorea saldo diariamente
    * Planifica para picos de volumen
  </Accordion>

  <Accordion title="Usar Red Correcta" icon="network-wired">
    * Polygon recomendado (tarifas más bajas)
    * Combina red en cotizaciones
    * Verifica dirección de depósito
    * Prueba con pequeña cantidad primero
  </Accordion>

  <Accordion title="Monitorear de Cerca" icon="eye">
    * Verifica saldo diariamente
    * Revisa logs de transacción
    * Reconcilia regularmente
    * Configura webhooks
  </Accordion>

  <Accordion title="Optimizar Precios" icon="chart-line">
    * Descuentos de volumen disponibles
    * Mejores tasas con pre-fondeo
    * Negocia precios personalizados
    * Rastrea ahorros vs. precios regulares
  </Accordion>
</AccordionGroup>

## Preguntas Frecuentes

<AccordionGroup>
  <Accordion title="¿Cuál es el saldo mínimo?" icon="dollar-sign">
    El depósito inicial mínimo es típicamente \$10.000 USD equivalente. El saldo recomendado depende de tu volumen de transacciones.
  </Accordion>

  <Accordion title="¿Puedo retirar de mi saldo pre-fondeado?" icon="money-bill-transfer">
    Sí, contacta a soporte para solicitar retiros. El procesamiento típicamente toma 1-3 días hábiles.
  </Accordion>

  <Accordion title="¿Qué pasa si se agota mi saldo?" icon="exclamation">
    Las transacciones fallarán si hay saldo insuficiente. Configura alertas de saldo bajo para evitar esto.
  </Accordion>

  <Accordion title="¿Hay tarifas de mantenimiento?" icon="percent">
    No hay tarifas de mantenimiento. Solo pagas tarifas de transacción al ejecutar ramps.
  </Accordion>

  <Accordion title="¿Puedo usar múltiples monedas?" icon="coins">
    Sí, mantén saldos separados para USDC y USDT si es necesario.
  </Accordion>
</AccordionGroup>

## Próximos Pasos

<CardGroup cols={2}>
  <Card title="Contactar Ventas" icon="phone" href="mailto:sales@killb.com">
    Comienza con pre-fondeo para tu negocio
  </Card>

  <Card title="API de Liquidez" icon="code" href="/api-reference/endpoint/customers-liquidity">
    Ve endpoints de gestión de liquidez
  </Card>

  <Card title="API de Saldo" icon="wallet" href="/api-reference/endpoint/customers-balances">
    Verifica y gestiona tus saldos
  </Card>

  <Card title="Guía de Pre-Fondeo" icon="book" href="/es/guides/accounts/pre-fund-accounts">
    Guía completa de implementación
  </Card>
</CardGroup>