Saltar al contenido principal

​
¿Qué son los Pagos?

Los pagos son dispersiones salientes que te permiten enviar fondos desde tu saldo pre-financiado de KillB a cualquier beneficiario — cuentas bancarias, billeteras cripto o alias de pago locales. Son la forma más simple de distribuir dinero a escala: sin paso de cotización, sin URL de pago, sin esperar acción del usuario final. Tú tienes el saldo; KillB lo enruta al destino.
Los pagos son una función B2B diseñada para empresas que necesitan dispersar fondos a muchos destinatarios (nómina, pagos a proveedores, liquidaciones de marketplace, distribuciones cripto, etc.).

​
Pagos vs. Ramps

Tanto los pagos como los ramps mueven dinero, pero sirven propósitos diferentes:

​
Cómo Funciona

​
Prerrequisitos

Cada pago requiere:
  1. Una cuenta pre-financiada activa — tiene el saldo a dispersar
  2. Saldo suficiente — igual o mayor al monto del pago
  3. Datos válidos del beneficiario — correspondientes a los campos requeridos del rail de pago elegido

Configurar Cuentas Pre-Financiadas

Aprende cómo crear y fondear tus cuentas pre-financiadas

​
Ciclo de Vida del Pago

FAILED y ERROR durante la fase de Cash In son terminales — no se recolectaron fondos, por lo que no se emite ningún reembolso. Para las fases siguientes (KYT Out, Cash Out), estos estados inician el flujo de reembolso. REJECTED también activa el flujo de reembolso, ya que solo ocurre después del Cash In.

​
Estados

​
Tipos de Beneficiario Soportados

​
Idempotencia

Para evitar dispersiones duplicadas en reintentos de red, envía un header único Idempotency-Key en cada solicitud de creación de pago. Si se recibe la misma clave dos veces, KillB devuelve el pago original en lugar de crear uno nuevo.

​
Preguntas Frecuentes

Depende de en qué fase ocurre el fallo:
  • Durante Cash In — No se recolectaron fondos, por lo que no se debita nada de tu saldo pre-financiado.
  • Después de Cash In (KYT Out, Cash Out) — Los fondos ya fueron recolectados. El pago transiciona al flujo de reembolso (REFUND_PENDING → REFUND_PROCESSING → REFUNDED), devolviéndolos a tu saldo pre-financiado.
Los pagos en estado CASH_IN_PENDING pueden ser cancelables — contacta al soporte. Una vez que el pago pasa a CASH_IN_PROCESSING, la cancelación ya no es posible ya que los fondos están en tránsito.
Cada estado refleja un origen de fallo distinto:
  • ERROR — Error interno del sistema en KillB. No se dispersaron fondos.
  • FAILED — El banco del beneficiario rechazó la transferencia por datos de cuenta inválidos o incorrectos proporcionados por el remitente.
  • REJECTED — El pago fue bloqueado por una revisión de cumplimiento en KillB. Los fondos son devueltos a tu saldo pre-financiado a través del flujo de reembolso.
Un pago entra en REVIEW_NEEDED cuando una verificación KYT (Know Your Transaction) marca la transacción para revisión manual. No se requiere acción de tu parte — el pago se reanudará automáticamente al completarse la revisión, o transitará a REJECTED si es bloqueado.
Un pago alcanza REFUNDED cuando FAILED o ERROR ocurre después de la fase de Cash In (KYT Out o Cash Out), o cuando el pago es REJECTED por cumplimiento. Como los fondos ya fueron recolectados, el pago avanza automáticamente por REFUND_PENDING → REFUND_PROCESSING → REFUNDED.Si FAILED o ERROR ocurre durante Cash In, no se recolectaron fondos y no se emite ningún reembolso.
Las transferencias Bank Transfer y BREB típicamente se liquidan en minutos a pocas horas hábiles dependiendo del banco y los horarios de corte.
Envía un header único Idempotency-Key en las solicitudes de creación de pagos. Si se recibe la misma clave dos veces (ej. en un reintento), KillB devuelve el pago original en lugar de crear una dispersión duplicada.

​
Mejores Prácticas

  • Verifica el saldo primero — siempre llama a GET /api/v2/customers/balances antes de crear un pago para evitar fallos por saldo insuficiente
  • Usa Idempotency-Key — siempre envía una clave única por dispersión para reintentar de forma segura sin duplicados
  • Suscríbete a webhooks — configura webhooks de eventos PAYOUT para actualizaciones de estado en tiempo real
  • Monitorea los pagos REJECTED — registra los datos completos del beneficiario en caso de rechazo para identificar y corregir datos inválidos de cuenta
  • Reconcilia diariamente — obtén todos los pagos del día anterior y compáralos con tu libro mayor interno

​
Guías Relacionadas

Crear un Pago

Guía de implementación paso a paso

Seguimiento de Estado

Monitorea pagos con webhooks y polling

Cuentas Pre-Financiadas

Fondea tus cuentas pre-financiadas

Webhooks

Notificaciones de eventos en tiempo real