Saltar al contenido principal

​
¿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.
Los pagos requieren una cuenta pre-financiada activa con saldo suficiente. Asegúrate de tener fondos depositados antes de crear un pago.

PSE

Saldo → Cuenta BancariaDispersa COP a cuentas bancarias colombianas vía PSE

BREB

Saldo → Alias RegistradoEnvía a teléfono, email o cédula vía BREB

​
Flujo de Transacción

1

Verificar Saldo

Verifica que tu cuenta pre-financiada tenga fondos suficientes
2

Crear Pago

Envía el pago con el ID de la cuenta pre-financiada, monto y datos del beneficiario
3

Procesamiento

KillB enruta el pago a la cuenta o billetera del beneficiario
4

Liquidación

Fondos entregados — recibe una notificación webhook al completarse

​
Conceptos Clave

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.
Los tipos de beneficiario actualmente soportados son PSE (transferencia a cuenta bancaria estándar) y BREB (alias registrado: teléfono, email o cédula). Cada tipo requiere campos específicos de cuenta.
Envía un header Idempotency-Key para reintentar la creación de pagos de forma segura sin riesgo de dispersiones duplicadas.
Suscríbete a eventos webhook de PAYOUT para recibir actualizaciones de estado en tiempo real para cada dispersión.

​
Inicio Rápido

// 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: 'PSE',
      account: {
        firstName: 'Maria',
        lastName: 'Garcia',
        email: '[email protected]',
        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

Crear un Pago

Implementación paso a paso con ejemplos de código

Seguimiento de Estado

Monitorea el progreso del pago con polling y webhooks

Cuentas Pre-Financiadas

Configura y financia tu cuenta pre-financiada

Referencia API

Documentación completa de la API de Pagos