¿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:| Pagos | Off-Ramps | |
|---|---|---|
| Dirección | Pre-fund → Beneficiario | Billetera cripto → Cuenta fiat |
| Quién inicia | Tu backend | Tu usuario final |
| ¿Cotización requerida? | No | Sí |
| ¿URL de pago? | No | Sí |
| Caso de uso | Dispersiones masivas, nómina, liquidaciones | Retiros de usuario |
| Fuente del saldo | Cuenta pre-financiada | Billetera cripto del usuario |
Cómo Funciona
Prerrequisitos
Cada pago requiere:- Una cuenta pre-financiada activa — tiene el saldo a dispersar
- Saldo suficiente — igual o mayor al monto del pago
- 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
Estados
| Estado | Significado |
|---|---|
CREATED | El pago ha sido recibido y persistido, en espera de entrar a la cola. |
PENDING | El pago está en cola esperando ser despachado al proveedor de pagos. |
PROCESSING | La dispersión ha sido enviada al proveedor de pagos y espera confirmación. |
COMPLETED | El proveedor confirmó la entrega exitosa de fondos al beneficiario. |
ERROR | Error interno del sistema. No se dispersaron fondos. |
FAILED | Dispersión rechazada por datos de cuenta del beneficiario inválidos o incorrectos. |
REJECTED | El pago fue bloqueado por una revisión de cumplimiento y no será procesado. |
REFUNDED | Los fondos dispersados han sido devueltos al saldo pre-financiado. |
Tipos de Beneficiario Soportados
| Tipo | Región | Descripción |
|---|---|---|
PSE | Colombia | Transferencia a cuenta bancaria vía PSE |
BREB | Colombia | Alias registrado (teléfono, email, cédula) |
Idempotencia
Para evitar dispersiones duplicadas en reintentos de red, envía un header únicoIdempotency-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
¿Qué pasa con mi saldo si un pago falla?
¿Qué pasa con mi saldo si un pago falla?
Si un pago alcanza el estado
FAILED, no se debitan fondos de tu saldo pre-financiado. El saldo solo se debita cuando el pago alcanza COMPLETED.¿Puedo cancelar un pago?
¿Puedo cancelar un pago?
Los pagos en estado
PENDING pueden ser cancelables — contacta al soporte. Una vez que el pago pasa a PROCESSING, la cancelación ya no es posible ya que los fondos están en tránsito.¿Cuál es la diferencia entre ERROR, FAILED y REJECTED?
¿Cuál es la diferencia entre ERROR, FAILED y REJECTED?
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 y no será procesado.
¿Cuándo ocurre el estado REFUNDED?
¿Cuándo ocurre el estado REFUNDED?
Un pago alcanza
REFUNDED cuando los fondos dispersados son devueltos a tu saldo pre-financiado — ya sea después de una entrega FAILED o, en algunos casos, después de un pago COMPLETED que fue posteriormente revertido por el banco del beneficiario.¿Cuánto tiempo tarda un pago?
¿Cuánto tiempo tarda un pago?
Las transferencias PSE y BREB típicamente se liquidan en minutos a pocas horas hábiles dependiendo del banco y los horarios de corte.
¿Cómo funciona la idempotencia?
¿Cómo funciona la idempotencia?
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/balancesantes 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
PAYOUTpara 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