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

# Visão Geral de Ramps

> Entendendo on-ramps e off-ramps

## O que são Ramps?

Ramps são transações que convertem entre moeda fiat e criptomoeda. Eles lidam com todo o processo desde o pagamento até a liquidação.

<CardGroup cols={2}>
  <Card title="On-Ramps" icon="arrow-up" href="/pt/guides/ramps/on-ramp">
    **Fiat → Cripto**

    Converta COP/MXN/USD para USDC/USDT
  </Card>

  <Card title="Off-Ramps" icon="arrow-down" href="/pt/guides/ramps/off-ramp">
    **Cripto → Fiat**

    Converta USDC/USDT para COP/MXN/USD
  </Card>
</CardGroup>

## Fluxo de Transação

<Steps>
  <Step title="Obter Cotação">
    Solicite uma cotação de preço com taxa bloqueada
  </Step>

  <Step title="Criar Ramp">
    Execute transação com ID da cotação
  </Step>

  <Step title="Pagamento/Depósito">
    Usuário completa pagamento
  </Step>

  <Step title="Conversão">
    KillB processa troca de moeda
  </Step>

  <Step title="Liquidação">
    Fundos entregues ao destino
  </Step>
</Steps>

## Conceitos Principais

<AccordionGroup>
  <Accordion title="Cotações Requeridas" icon="calculator">
    Todo ramp precisa de uma cotação para bloquear a taxa de câmbio
  </Accordion>

  <Accordion title="Expiração de 30 Segundos" icon="clock">
    Cotações expiram após 30 segundos para prevenir arbitragem de taxa
  </Accordion>

  <Accordion title="Rastreamento de Status" icon="list-check">
    Monitore o progresso do ramp através de atualizações de status
  </Accordion>

  <Accordion title="Notificações de Webhook" icon="bell">
    Obtenha atualizações em tempo real via webhooks
  </Accordion>
</AccordionGroup>

## Início Rápido

```javascript theme={null}
// 1. Obter cotação
const quote = await createQuotation({
  fromCurrency: 'COP',
  toCurrency: 'USDC',
  amount: 100000,
  amountIsToCurrency: false,
  cashInMethod: 'PSE',
  cashOutMethod: 'POLYGON'
});

// 2. Criar ramp
const ramp = await createRamp({
  quotationId: quote.id,
  userId: 'user-id',
  accountId: 'wallet-id'
});

// 3. Usuário paga via URL fornecida
window.location.href = ramp.paymentInfo[0].url;
```

## Próximos Passos

<CardGroup cols={2}>
  <Card title="Guia On-Ramp" icon="arrow-up" href="/pt/guides/ramps/on-ramp">
    Implemente conversão fiat para cripto
  </Card>

  <Card title="Guia Off-Ramp" icon="arrow-down" href="/pt/guides/ramps/off-ramp">
    Implemente conversão cripto para fiat
  </Card>

  <Card title="Rastreamento de Status" icon="chart-line" href="/pt/guides/ramps/ramp-status">
    Monitore o progresso do ramp
  </Card>

  <Card title="Referência da API" icon="code" href="/api-reference/endpoint/ramps-create">
    Documentação completa da API de Ramps
  </Card>
</CardGroup>