Cobros
Crea, consulta y lista cobros; cada uno trae el link a su checkout.
Crea tus llaves
Desde el panel, una llave de prueba y una de producción.
Desarrolladores
Una API para cobrar desde tu sistema.
Creas el cobro con una llamada, rediriges a tu cliente al checkout de Winora y te avisamos por webhook cuando paga. Con llaves de prueba para integrar sin mover dinero real.
20direcciones de webhook
6intentos por entrega
Por qué
Integrar pagos no debería ser un proyecto de meses.
Formularios de tarjeta, estados de cada pago, reintentos y conciliación. Winora resuelve el cobro y te deja una API pequeña y predecible para conectarlo a tu producto.
Cómo funciona
01
02
Crea el cobro
POST /api/v1/charges con monto, referencia y correo del cliente.
03
Redirige al checkout
La respuesta trae el checkoutUrl para tu cliente.
04
Escucha el webhook
payment.approved te dice cuándo entregar lo vendido.
Webhooks
Si tu servidor falla, volvemos a intentar.
Cada evento llega firmado con HMAC-SHA256 en el header Winora-Signature, con la marca de tiempo. Si tu servidor no responde, reintentamos hasta 6 veces.
- Pagos, reembolsos y cartera
- Firma con marca de tiempo contra ataques de repetición
- Esperas de 1 min, 5 min, 30 min, 2 h y 6 h
- Hasta 20 direcciones de webhook por comercio
Qué incluye
Todo lo que necesitas para cobrar.
Reembolsos
Totales o parciales sobre los pagos aprobados.
Cartera
Crea deudas una a una o por lotes, registra pagos y consulta su estado.
Suscripciones
Crea planes y suscripciones, y entérate de cada cobro con los webhooks subscription.*.
Webhooks firmados
HMAC-SHA256 con marca de tiempo, y hasta 6 intentos si tu servidor no responde.
Idempotencia
Con el header Idempotency-Key, reintentar una petición no duplica nada.
Modo prueba
Las llaves wk_test_ usan el entorno de pruebas del adquirente.
Límites claros
60 peticiones cada 10 segundos por llave, y paginación de hasta 100.
WooCommerce
Si vendes en WordPress, pide el plugin a nuestro equipo y conecta tus llaves.
Para quién
Para equipos que construyen su propio producto.
SaaS y plataformas
Cobra a tus usuarios dentro de tu producto.
Tiendas a la medida
Conecta tu propio carrito al checkout de Winora.
Software de cartera
Sube las deudas desde tu sistema y entérate de cada pago.
Agencias
Integra los cobros de tus clientes con una sola API.
Precio
La API no cuesta aparte.
Usar la API y los webhooks no tiene costo adicional: cada pago lleva la comisión del modelo con el que cobra el comercio.
Lo que cobra Winora siempre lleva IVA.
Sin datos de tarjeta en tu servidor
Tu cliente escribe la tarjeta en el checkout de Winora, con el formulario del adquirente.
Llaves con modo
La llave decide si es prueba o producción: no hay forma de confundirlos en el cuerpo.
Protección de las llaves
Demasiados intentos fallidos desde una misma IP se bloquean por un rato.
Preguntas frecuentes.
01¿Dónde está la documentación?
En la guía para integradores del panel: autenticación, cobros, webhooks, reembolsos, cartera, idempotencia y errores, con ejemplos.
02¿Puedo crear links de pago por API?
Hoy no: los links se crean desde el panel. Desde tu sistema creas cobros con POST /api/v1/charges, que también te dan un link al checkout.
03¿Hay SDKs?
No por ahora. La API es REST con JSON y se usa con cualquier cliente HTTP. Para WordPress existe el plugin de WooCommerce.
04¿Cómo verifico un webhook?
Calcula el HMAC-SHA256 de "marca de tiempo.cuerpo" con tu secreto whsec_ y compáralo con el valor v1 del header Winora-Signature.
05¿Los webhooks de prueba van a otra dirección?
Hoy no hay separación: tus direcciones de webhook reciben los eventos de los dos modos. Tu sistema debe reconocer cada cobro por la referencia que le dio al crearlo.
06¿Cobro en centavos?
No. Los montos van en pesos colombianos enteros: 120000 son $ 120.000.
También te puede servir
Pagos en línea
Checkout con tarjeta y PSE, por API o WooCommerce
Cartera y recaudo
Recordatorios, cobros recurrentes y paz y salvo
Links de pago
Un link o un QR para cobrar sin página web
Empieza a integrar hoy.
Crea tu cuenta, genera una llave de prueba y haz tu primer cobro de prueba.