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

> Habilite execução instantânea de transações com saldos pré-financiados

## Visão Geral

Contas pré-financiadas permitem que você mantenha um saldo com a KillB para execução instantânea de transações sem esperar pela confirmação de pagamento.

<Info>
  Contas pré-financiadas oferecem a experiência de transação mais rápida e são ideais para operações de alto volume.
</Info>

## Benefícios

<CardGroup cols={2}>
  <Card title="Execução Instantânea" icon="bolt">
    Transações executam imediatamente sem atrasos de pagamento
  </Card>

  <Card title="Melhores Taxas" icon="tag">
    Taxas reduzidas para transações pré-financiadas
  </Card>

  <Card title="Fluxo Simplificado" icon="diagram-project">
    Não são necessárias URLs de pagamento ou confirmações
  </Card>

  <Card title="Liquidação Previsível" icon="clock">
    Saiba exatamente quando os fundos chegarão
  </Card>
</CardGroup>

## Como Funciona

<Steps>
  <Step title="Criar Conta Pré-Financiada">
    Solicite uma conta dedicada para sua moeda/rede
  </Step>

  <Step title="Depositar Fundos">
    Transfira fundos para o endereço/conta fornecido
  </Step>

  <Step title="Verificar Saldo">
    Verifique seu saldo pré-financiado
  </Step>

  <Step title="Criar Ramps">
    Use métodos de pré-financiamento em cotações
  </Step>

  <Step title="Execução Instantânea">
    Ramps executam imediatamente do seu saldo
  </Step>
</Steps>

## Métodos de Pré-Financiamento Suportados

**Cripto:**

* `PRE_FUND_POLYGON` - USDC/USDT no Polygon
* `PRE_FUND_ERC20` - USDC/USDT no Ethereum
* `PRE_FUND_SOLANA` - USDC/USDT no Solana
* `PRE_FUND_TRON` - USDC/USDT no Tron
* `PRE_FUND_ARBITRUM` - USDC/USDT no Arbitrum

**Fiat:**

* `PRE_FUND` - Saldo fiat USD, COP, MXN

## Usando Pré-Financiamento em Ramps

Especifique método de pré-financiamento na cotação:

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

O ramp será executado instantaneamente se você tiver saldo pré-financiado suficiente.

## Verificando Saldo

Obtenha seus saldos pré-financiados:

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

```javascript theme={null}
const getPreFundBalance = async () => {
  const response = await fetch(
    'https://sandbox.killb.app/api/v2/customers/balances',
    {
      headers: {
        'Authorization': `Bearer ${token}`
      }
    }
  );
  
  const balances = await response.json();
  
  // Encontrar saldo USDC
  const usdcBalance = balances.find(b => b.currency === 'USDC');
  console.log('Saldo USDC:', usdcBalance.amount);
  
  return balances;
};
```

## Melhores Práticas

<AccordionGroup>
  <Accordion title="Monitorar Saldo" icon="gauge">
    ```javascript theme={null}
    const checkBeforeRamp = async (requiredAmount) => {
      const balances = await getPreFundBalance();
      const usdcBalance = parseFloat(balances.find(b => b.currency === 'USDC').amount);
      
      if (usdcBalance < requiredAmount) {
        throw new Error(`Saldo insuficiente. Precisa ${requiredAmount}, tem ${usdcBalance}`);
      }
    };
    ```
  </Accordion>

  <Accordion title="Configurar Alertas de Saldo Baixo" icon="bell">
    ```javascript theme={null}
    const balance = await getPreFundBalance();
    const threshold = 1000; // Alertar em $1000

    if (balance.amount < threshold) {
      await sendAlert('Saldo pré-financiado baixo', balance);
    }
    ```
  </Accordion>
</AccordionGroup>

## Próximos Passos

<CardGroup cols={2}>
  <Card title="Verificar Liquidez" icon="chart-line" href="/api-reference/endpoint/customers-liquidity">
    Veja sua liquidez disponível
  </Card>

  <Card title="Criar Ramps" icon="arrow-right-arrow-left" href="/pt/guides/ramps/overview">
    Use pré-financiamento em transações ramp
  </Card>
</CardGroup>