Saltar al contenido
Desarrolladores

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.

< 30 min

Integración básica por API

+50

Eventos de webhook firmados

6

Intentos de entrega por evento, en unos 9 minutos

90 días

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.

Crear un cobro: POST /v1/payments
bash
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.

Verificar un webhook
javascript
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 = crypto
12 .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 segundos
25});

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
API de facturas
bash
# Ciclo de vida de una factura
POST /v1/invoices # crea la factura y su cobro
PUT /v1/invoices/{id} # actualiza el valor o los datos
DELETE /v1/invoices/{id} # anula o marca pagada por fuera
GET /v1/invoices/{id} # consulta el estado
# Webhook que recibe tu sistema
invoice.paid # la factura se pagó en OnePay

Homologació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.

1

Crea tu cuenta

Regístrate en admin.onepay.la y completa el perfil legal de la empresa.

2

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.

3

Configura el checkout y la marca

Logo, colores, subdominio, métodos de pago, datos de soporte y documentos legales.

4

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.

5

Configura la cobranza

Reglas por etapa, plantillas, horario, llamadas con IA si aplica y línea de WhatsApp propia o compartida.

6

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.

Wispro

Software de gestión para ISP

Ver integración

WispHub

Software de gestión para ISP

Ver integración

MikroWISP

Software de gestión para ISP

SAEplus

Software de gestión para ISP

Wispcontrol

Software de gestión para ISP

Siigo

Software contable y de facturación

Ver integración

Alegra

Software contable y de facturación

API de facturas

Para software propio, ERP y cualquier otro sistema

Ver integració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 integraciones

Enviar 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 WhatsApp

Cobrar cuotas con débito automático

Tokeniza tarjetas, cuentas y billeteras, y cobra cada ciclo con planes y suscripciones.

Suscripciones y débitos

Cobrar 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 empresas

Pagar a proveedores y técnicos

Crea dispersiones individuales o masivas por Bre-B, Turbo o ACH desde el mismo saldo.

Dispersiones

Ofrecer pagos con tu marca

Si tienes un software, integra la infraestructura de recaudo de OnePay y preséntala como tu producto.

Infraestructura como servicio

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