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

# Contas Pré-Financiadas

> Execução instantânea de transações com liquidez pré-depositada

## O que são Contas Pré-Financiadas?

Contas pré-financiadas são **contas de saldo** que permitem que você mantenha liquidez com a KillB para execução instantânea de transações. Em vez de esperar pelos pagamentos dos usuários, as transações são executadas imediatamente de seus fundos pré-depositados.

<Info>
  Pré-financiamento é ideal para empresas com alto volume de transações que precisam de liquidações instantâneas e melhores taxas.
</Info>

## Como Funciona

<Steps>
  <Step title="Criar Conta Pré-Financiada">
    Solicite uma carteira ou conta dedicada da KillB

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

  <Step title="Depositar Fundos">
    Transfira USDC/USDT para seu endereço de pré-financiamento dedicado

    **Redes Suportadas:**

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

  <Step title="Usar em Transações">
    Especifique método de pré-financiamento ao criar cotações

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

  <Step title="Execução Instantânea">
    Transações executam imediatamente sem esperar por pagamento

    ⚡ Fundos deduzidos do seu saldo instantaneamente
  </Step>
</Steps>

## Métodos de Pré-Financiamento

| Método              | Ativo     | Rede     | Descrição          |
| ------------------- | --------- | -------- | ------------------ |
| `PRE_FUND_POLYGON`  | USDC/USDT | Polygon  | Taxas mais baixas  |
| `PRE_FUND_ETHEREUM` | USDC/USDT | Ethereum | Mais comum         |
| `PRE_FUND_ARBITRUM` | USDC/USDT | Arbitrum | Taxas baixas       |
| `PRE_FUND_BASE`     | USDC/USDT | Base     | Novo, taxas baixas |
| `PRE_FUND_SOLANA`   | USDC      | Solana   | Rápido, barato     |

<Tip>
  **Recomendado:** Use `PRE_FUND_POLYGON` para as taxas de rede mais baixas e processamento mais rápido.
</Tip>

## Benefícios

<CardGroup cols={2}>
  <Card title="Execução Instantânea" icon="bolt">
    Sem espera por pagamentos do usuário - transações executam imediatamente
  </Card>

  <Card title="Melhores Taxas" icon="chart-line">
    Preços baseados em volume com taxas de câmbio preferenciais
  </Card>

  <Card title="Fluxo Simplificado" icon="route">
    Pule a etapa de cobrança de pagamento - execução direta
  </Card>

  <Card title="Liquidação Previsível" icon="clock">
    Saiba exatamente quando as transações serão concluídas
  </Card>

  <Card title="Operações em Massa" icon="layer-group">
    Processe altos volumes eficientemente
  </Card>

  <Card title="Reconciliação Fácil" icon="calculator">
    Saldo único para rastrear todas as transações
  </Card>
</CardGroup>

## Casos de Uso

### Empresas de Alto Volume

<Tabs>
  <Tab title="Plataforma de Exchange">
    **Cenário:** Exchange cripto precisa processar 1000+ off-ramps diariamente

    **Sem Pré-Financiamento:**

    * Esperar cada usuário enviar cripto
    * Monitorar 1000+ depósitos individuais
    * Reconciliação complexa

    **Com Pré-Financiamento:**

    * Manter pool de liquidez
    * Executar todas as transações instantaneamente
    * Rastreamento simples de saldo
  </Tab>

  <Tab title="Processador de Pagamentos">
    **Cenário:** Gateway de pagamento convertendo cripto para fiat para comerciantes

    **Sem Pré-Financiamento:**

    * Esperar por cada pagamento
    * Tempo imprevisível
    * Rastreamento complexo

    **Com Pré-Financiamento:**

    * Pagamentos instantâneos aos comerciantes
    * Operações previsíveis
    * Melhor experiência do comerciante
  </Tab>

  <Tab title="Serviço de Remessas">
    **Cenário:** Serviço de transferência de dinheiro enviando fundos para América Latina

    **Sem Pré-Financiamento:**

    * Esperar pagamento do remetente
    * Entrega atrasada ao destinatário
    * Experiência do usuário ruim

    **Com Pré-Financiamento:**

    * Entrega instantânea ao destinatário
    * Melhores taxas de câmbio
    * Maior satisfação do cliente
  </Tab>
</Tabs>

## Configurando Pré-Financiamento

### Passo 1: Solicitar Conta Pré-Financiada

Entre em contato com a KillB para habilitar pré-financiamento:

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

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

**Resposta:**

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

### Passo 2: Depositar Fundos Iniciais

Envie USDC/USDT para o endereço de depósito fornecido:

```bash theme={null}
# Depósito inicial mínimo: $10.000 USD equivalente
# Recomendado: $50.000+ para operações otimizadas
```

<Warning>
  Sempre envie para a rede correta! Enviar para rede errada = fundos perdidos.
</Warning>

### Passo 3: Monitorar Saldo

Verifique seu saldo pré-financiado:

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

**Resposta:**

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

### Passo 4: Usar em Transações

Crie cotações usando método de pré-financiamento:

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

## Gestão de Saldo

### Verificar Saldo

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

### Recarregar Saldo

Envie USDC/USDT adicional para seu endereço de depósito a qualquer momento.

### Alertas de Saldo Baixo

Configure webhooks para receber alertas quando o saldo estiver baixo:

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

<Tip>
  Configure alertas de saldo baixo para evitar falhas de transação devido a fundos insuficientes.
</Tip>

## Fluxo de Transação com Pré-Financiamento

<Steps>
  <Step title="Criar Cotação">
    Especifique `PRE_FUND_*` como cashInMethod

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

  <Step title="Criar Ramp">
    Use cotação para criar ramp

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

  <Step title="Execução Instantânea">
    ✅ Fundos imediatamente deduzidos do saldo pré-financiado

    ✅ Transação processa sem espera

    ✅ Fiat enviado para conta bancária do usuário
  </Step>

  <Step title="Saldo Atualizado">
    Seu saldo diminui pelo valor da transação + taxas
  </Step>
</Steps>

## Preços e Taxas

Contas pré-financiadas recebem preços preferenciais:

| Volume de Transação (Mensal) | Desconto de Taxa      | Melhoria na Taxa de Câmbio |
| ---------------------------- | --------------------- | -------------------------- |
| $100K - $500K                | Redução de 0,1%       | Taxa padrão                |
| $500K - $1M                  | Redução de 0,2%       | 0,05% melhor               |
| $1M - $5M                    | Redução de 0,3%       | 0,10% melhor               |
| \$5M+                        | Preços personalizados | 0,15%+ melhor              |

<Info>
  Entre em contato com [sales@killb.com](mailto:sales@killb.com) para preços de volume empresarial.
</Info>

## Gestão de Liquidez

### Saldo Ótimo

**Saldo recomendado:**

```
Volume Diário × 3 dias = Saldo Ótimo

Exemplo:
- Volume diário: $50.000
- Recomendado: saldo de $150.000
```

Isso garante:

* 3 dias de operações
* Buffer para picos de volume
* Sem falhas de transação

## Melhores Práticas

<AccordionGroup>
  <Accordion title="Manter Saldo Suficiente" icon="wallet">
    * Mantenha 3-5 dias de capital operacional
    * Configure alertas de saldo baixo
    * Monitore saldo diariamente
    * Planeje para picos de volume
  </Accordion>

  <Accordion title="Usar Rede Correta" icon="network-wired">
    * Polygon recomendado (taxas mais baixas)
    * Combine rede nas cotações
    * Verifique endereço de depósito
    * Teste com pequena quantia primeiro
  </Accordion>

  <Accordion title="Monitorar de Perto" icon="eye">
    * Verifique saldo diariamente
    * Revise logs de transação
    * Reconcilie regularmente
    * Configure webhooks
  </Accordion>

  <Accordion title="Otimizar Preços" icon="chart-line">
    * Descontos de volume disponíveis
    * Melhores taxas com pré-financiamento
    * Negocie preços personalizados
    * Rastreie economias vs. preços regulares
  </Accordion>
</AccordionGroup>

## Perguntas Frequentes

<AccordionGroup>
  <Accordion title="Qual é o saldo mínimo?" icon="dollar-sign">
    O depósito inicial mínimo é normalmente \$10.000 USD equivalente. O saldo recomendado depende do seu volume de transações.
  </Accordion>

  <Accordion title="Posso sacar do meu saldo pré-financiado?" icon="money-bill-transfer">
    Sim, entre em contato com o suporte para solicitar saques. O processamento normalmente leva 1-3 dias úteis.
  </Accordion>

  <Accordion title="O que acontece se meu saldo acabar?" icon="exclamation">
    As transações falharão se houver saldo insuficiente. Configure alertas de saldo baixo para evitar isso.
  </Accordion>

  <Accordion title="Há taxas de manutenção?" icon="percent">
    Não há taxas de manutenção. Você paga apenas taxas de transação ao executar ramps.
  </Accordion>

  <Accordion title="Posso usar múltiplas moedas?" icon="coins">
    Sim, mantenha saldos separados para USDC e USDT se necessário.
  </Accordion>
</AccordionGroup>

## Próximos Passos

<CardGroup cols={2}>
  <Card title="Contatar Vendas" icon="phone" href="mailto:sales@killb.com">
    Comece com pré-financiamento para seu negócio
  </Card>

  <Card title="API de Liquidez" icon="code" href="/api-reference/endpoint/customers-liquidity">
    Veja endpoints de gestão de liquidez
  </Card>

  <Card title="API de Saldo" icon="wallet" href="/api-reference/endpoint/customers-balances">
    Verifique e gerencie seus saldos
  </Card>

  <Card title="Guia de Pré-Financiamento" icon="book" href="/pt/guides/accounts/pre-fund-accounts">
    Guia completo de implementação
  </Card>
</CardGroup>