La API de pagos para Colombia.
Webhooks incluidos.
Cobros, débitos automáticos, facturas y dispersiones con una API REST versionada, SDK para Node.js y Python, y más de 50 eventos de webhook firmados. Integración básica en menos de 30 minutos.
La API de OnePay en cifras
Lo que necesitas saber antes de escribir la primera línea de código.
Integración básica por API
Eventos de webhook firmados
Intentos de entrega por evento, en unos 9 minutos
De registro de peticiones y respuestas en el panel
Una sola llamada, múltiples canales
Crea un cobro con POST /v1/payments. Con phone llega por WhatsApp, con email por correo y con reference queda disponible en el portal de pagos. Sin amount, el link es de monto abierto; con expiration_date y allows defines la vigencia y los métodos permitidos.
1curl https://api.onepay.la/v1/payments \2 -X POST \3 -H "Authorization: Bearer sk_test_..." \4 -H "Content-Type: application/json" \5 -H "x-idempotency: factura-1234" \6 -d '{7 "amount": 150000,8 "currency": "COP",9 "title": "Factura #1234",10 "phone": "+573201112233",11 "email": "pagador@ejemplo.com",12 "reference": "FAC-1234",13 "expiration_date": "2026-10-31 23:59:59",14 "allows": { "cards": true, "pse": true, "wallets": true, "breb": true }15 }'Todo para integrar pagos en Colombia
API REST, webhooks, sandbox, SDK, Elements, conectores y servidor MCP en una sola plataforma.
API REST versionada
Llaves secretas (sk) para tu servidor y públicas (pk) para la interfaz web. Una sola URL base para pruebas y producción: el ambiente lo define la llave.
Idempotencia nativa
Envía una clave de idempotencia en cada petición y nunca proceses un pago dos veces, aunque reintentes.
Registro de 90 días
Cada petición y respuesta queda registrada 90 días en el panel, junto con el historial de entregas de cada webhook.
Más de 50 eventos de webhook
Pagos, cargos, transferencias, suscripciones, cuentas, facturas, empresa, servicios públicos, saldo y mensajes de WhatsApp.
Sandbox completo
La misma API con tarjetas de prueba y escenarios para simular resultados, sin mover dinero.
SDK para Node.js y Python
Integra desde tu backend con el SDK de Node.js o de Python, o llama la API REST directamente desde cualquier lenguaje.
Elements para PCI
Captura los datos de tarjeta en tu sitio sin tocar datos sensibles: el cumplimiento PCI queda del lado de OnePay.
Servidor MCP
Consulta saldos, cobros, pagos, transferencias y clientes desde Claude o Cursor en lenguaje natural, en modo de solo lectura (mcp.onepay.la).
Webhooks firmados que puedes verificar
Más de 50 eventos. Cada envío va firmado, se entrega en hasta 6 intentos en unos 9 minutos y se puede reenviar desde el panel. Si un webhook falla de forma sostenida, se deshabilita y te avisamos por correo.
1import crypto from "node:crypto";2import express from "express";3
4const app = express();5
6const safeEqual = (a, b) =>7 a.length === b.length && crypto.timingSafeEqual(Buffer.from(a), Buffer.from(b));8
9// Usa el cuerpo sin parsear: si lo reserializas, la firma no coincide.10app.post("/webhooks/onepay", express.raw({ type: "application/json" }), (req, res) => {11 const expected = crypto12 .createHmac("sha256", process.env.ONEPAY_WEBHOOK_SECRET)13 .update(req.body)14 .digest("hex");15
16 const valid =17 safeEqual(req.get("x-webhook-token") ?? "", process.env.ONEPAY_WEBHOOK_TOKEN) &&18 safeEqual(req.get("signature") ?? "", expected);19
20 if (!valid) return res.sendStatus(401);21
22 const payload = JSON.parse(req.body.toString());23 console.log(payload.event.type); // "payment.approved", "invoice.paid", ...24 res.sendStatus(200); // responde 2xx en menos de 10 segundos25});Módulos de la API
Todo lo que hace OnePay también se opera por API, desde el cobro hasta la conciliación y la dispersión.
- Clientes
- Cuentas y llaves Bre-B
- Tarjetas tokenizadas
- Cobros
- Cargos (débitos automáticos)
- Request to pay a Nequi y Daviplata
- Sesión de cliente con verificación por WhatsApp
- Campañas
- Productos
- Precios
- Planes y suscripciones
- Facturas
- Facturación electrónica
- Dispersiones
- Saldos y movimientos
- Billeteras
- Tarjetas de emisión
- Servicios públicos
- Flujos
Algunos módulos, como tarjetas de emisión y servicios públicos, se activan con el equipo de OnePay. La facturación electrónica ante la DIAN está disponible por API.
API de facturas para tu software, ERP o sistema de gestión
Tú generas la factura; OnePay la cobra, la concilia y te avisa por webhook. Es la vía para software propio, ERP y aliados.
Crea, actualiza, anula y marca facturas como pagadas
Cada factura genera su cobro y sale por WhatsApp o correo con un link único. Cuando el usuario final paga, recibes el webhook y la factura queda pagada.
- POST /invoices crea la factura y su cobro, sin duplicar facturas idénticas
- PUT /invoices/{id} actualiza el valor (por ejemplo, un recargo por mora) y reenvía el cobro
- DELETE /invoices/{id} anula la factura o la marca pagada por fuera, y los recordatorios se detienen
- El webhook invoice.paid confirma cada pago hecho a través de OnePay
# Ciclo de vida de una facturaPOST /v1/invoices # crea la factura y su cobroPUT /v1/invoices/{id} # actualiza el valor o los datosDELETE /v1/invoices/{id} # anula o marca pagada por fueraGET /v1/invoices/{id} # consulta el estado
# Webhook que recibe tu sistemainvoice.paid # la factura se pagó en OnePayHomologación antes de producción
Si conectas tu propio sistema por la API de facturas, OnePay revisa la integración antes de habilitar la llave de producción.
Revisión del tráfico de prueba
- Número de factura único
- Referencia estable del cliente
- Teléfono o correo en cada factura
- Vencimiento real
- Cambios de valor por actualización
- Pagos en caja reportados con recibo y medio de pago
- Webhook suscrito y respondiendo
Prueba integral de seis pasos
- Crear la misma factura dos veces
- Pagarla y ver la reconexión
- Actualizarla
- Marcarla pagada por fuera
- Anular otra factura
- Recibir el rechazo al intentar anular una pagada
Al aprobarse
- Llave y webhook de producción
- Primera factura real acompañada por el equipo de OnePay
- Limpieza de las facturas de prueba
Modo de prueba y producción
Dos ambientes completamente separados, cada uno con sus propias llaves de API, sobre la misma URL base.
Modo de prueba
Recorres todo el flujo sin mover dinero: cobros, checkout con tarjetas de prueba, API y transferencias simuladas. Lo usas desde el primer día, mientras se verifica tu empresa.
Producción
Nada pasa de un ambiente al otro automáticamente. Cuando la integración funciona en prueba, repites la configuración con las credenciales de producción.
¿Cuánto tarda la integración?
Tiempos de referencia desde que creas la cuenta hasta que cobras.
Minutos
Cuenta activa
La verificación de la empresa toma de 1 a 3 días hábiles.
El mismo día
Sin código
Links de pago y portal marca blanca desde el panel.
Menos de 30 min
Integración básica por API
Tu primer cobro creado desde tu backend.
1 a 2 días hábiles
Integración completa
Con cobranza inteligente, WhatsApp y portal personalizado.
Menos de 48 horas
Conectores para ISP
Wispro, WispHub, SAEplus y MikroWISP, sin desarrollo.
Menos de 10 min
Siigo
OnePay lee tus facturas, las cobra y las marca como pagadas.
Cómo empezar en seis pasos
De la cuenta al primer cobro real, acompañado por el equipo de OnePay.
Crea tu cuenta
Regístrate en admin.onepay.la y completa el perfil legal de la empresa.
Verifica tu empresa
Carga el RUT, el certificado de cámara de comercio, la cédula del representante legal y la certificación bancaria, y completa la verificación de identidad. Mientras tanto, todo se puede recorrer en modo de prueba.
Configura el checkout y la marca
Logo, colores, subdominio, métodos de pago, datos de soporte y documentos legales.
Conecta tus facturas
Con el conector de tu software de gestión, Siigo o Alegra, la API de facturas o la importación por archivo.
Configura la cobranza
Reglas por etapa, plantillas, horario, llamadas con IA si aplica y línea de WhatsApp propia o compartida.
Haz tu primer cobro real
Acompañado por el equipo de OnePay. Después eliges la dispersión diaria o retiros a tu cuenta.
Conectores listos, sin desarrollo
Si tus facturas ya viven en un software de gestión o contable, conéctalo sin escribir código.
MikroWISP
Software de gestión para ISP
SAEplus
Software de gestión para ISP
Wispcontrol
Software de gestión para ISP
Alegra
Software contable y de facturación
Qué puedes construir con la API
Cada caso se apoya en un producto de OnePay. Conoce el detalle en su página.
Cobrar la factura mensual desde tu sistema
Sincroniza facturas por API, envía el cobro por WhatsApp y concilia cada pago en tiempo real.
Facturas e integracionesEnviar cobros por WhatsApp
Un cobro con phone llega al chat con el monto, el vencimiento y un link para pagar en 4 clics.
Cobros por WhatsAppCobrar cuotas con débito automático
Tokeniza tarjetas, cuentas y billeteras, y cobra cada ciclo con planes y suscripciones.
Suscripciones y débitosCobrar con QR o llave Bre-B
Genera un QR Bre-B por cobro con POST /charges/bre-b y recibe la confirmación en segundos.
Bre-B para empresasPagar a proveedores y técnicos
Crea dispersiones individuales o masivas por Bre-B, Turbo o ACH desde el mismo saldo.
DispersionesOfrecer pagos con tu marca
Si tienes un software, integra la infraestructura de recaudo de OnePay y preséntala como tu producto.
Infraestructura como servicioPreguntas frecuentes sobre la API
Lo que más preguntan los equipos técnicos antes de integrar OnePay.
¿Listo para integrar?
Lee la documentación completa o habla con nuestro equipo técnico para planear tu integración.