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

# Visión General de Pagos

> Dispersa fondos desde tu saldo pre-financiado directamente a beneficiarios

## ¿Qué son los Pagos?

Los pagos te permiten enviar dinero desde tu saldo pre-financiado de KillB directamente a cualquier beneficiario — cuentas bancarias, billeteras cripto o alias de pago locales. A diferencia de los ramps, no hay paso de cotización ni URL de pago: ya tienes el saldo y lo envías al destino de inmediato.

<Info>
  Los pagos requieren una cuenta pre-financiada activa con saldo suficiente. Asegúrate de tener fondos depositados antes de crear un pago.
</Info>

<CardGroup cols={2}>
  <Card title="Bank Transfer" icon="building-columns">
    **Saldo → Cuenta Bancaria**

    Dispersa COP a cuentas bancarias colombianas vía Bank Transfer
  </Card>

  <Card title="BREB" icon="id-card">
    **Saldo → Alias Registrado**

    Envía a teléfono, email o cédula vía BREB
  </Card>
</CardGroup>

## Flujo de Transacción

<Steps>
  <Step title="Verificar Saldo">
    Verifica que tu cuenta pre-financiada tenga fondos suficientes
  </Step>

  <Step title="Crear Pago">
    Envía el pago con el ID de la cuenta pre-financiada, monto y datos del beneficiario
  </Step>

  <Step title="Procesamiento">
    KillB enruta el pago a la cuenta o billetera del beneficiario
  </Step>

  <Step title="Liquidación">
    Fondos entregados — recibe una notificación webhook al completarse
  </Step>
</Steps>

## Conceptos Clave

<AccordionGroup>
  <Accordion title="Cuenta Pre-Financiada Requerida" icon="vault">
    Cada pago se debita de una cuenta pre-financiada. Debes tener una creada y con fondos antes de iniciar un pago. Los pagos fallarán si el saldo es insuficiente.
  </Accordion>

  <Accordion title="Tipos de Beneficiario" icon="users">
    Los tipos de beneficiario actualmente soportados son **Bank Transfer** (transferencia a cuenta bancaria estándar) y **BREB** (alias registrado: teléfono, email o cédula). Cada tipo requiere campos específicos de cuenta.
  </Accordion>

  <Accordion title="Idempotencia con Header" icon="fingerprint">
    Envía un header `Idempotency-Key` para reintentar la creación de pagos de forma segura sin riesgo de dispersiones duplicadas.
  </Accordion>

  <Accordion title="Notificaciones Webhook" icon="bell">
    Suscríbete a eventos webhook de `PAYOUT` para recibir actualizaciones de estado en tiempo real para cada dispersión.
  </Accordion>
</AccordionGroup>

## Inicio Rápido

```javascript theme={null}
// 1. Verificar saldo pre-financiado
const balances = await fetch('/api/v2/customers/balances', {
  headers: { 'Authorization': `Bearer ${token}` }
}).then(r => r.json());

// 2. Crear un pago
const payout = await fetch('/api/v2/payouts', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json',
    'Idempotency-Key': 'pago-2024-001'
  },
  body: JSON.stringify({
    preFundAccountId: 'prefund-account-id',
    amount: 500000, // 500,000 COP
    beneficiary: {
      type: 'BANK',
      account: {
        firstName: 'Maria',
        lastName: 'Garcia',
        email: 'maria@ejemplo.com',
        phone: '3001234567',
        document: { type: 'CC', number: '12345678' },
        accountNumber: '123456789',
        bankCode: '001',
        type: 'savings',
        countryCode: 'CO'
      }
    }
  })
}).then(r => r.json());

console.log('Pago creado:', payout.id, '| Estado:', payout.status);
```

## Próximos Pasos

<CardGroup cols={2}>
  <Card title="Crear un Pago" icon="paper-plane" href="/es/guides/payouts/create-payout">
    Implementación paso a paso con ejemplos de código
  </Card>

  <Card title="Seguimiento de Estado" icon="chart-line" href="/es/guides/payouts/payout-status">
    Monitorea el progreso del pago con polling y webhooks
  </Card>

  <Card title="Cuentas Pre-Financiadas" icon="vault" href="/es/guides/pre-fund/pre-fund-accounts">
    Configura y financia tu cuenta pre-financiada
  </Card>

  <Card title="Referencia API" icon="code" href="/api-reference/endpoint/payouts-create">
    Documentación completa de la API de Pagos
  </Card>
</CardGroup>