Visión general para desarrolladores
Lo que puedes integrar con Vipter hoy (webhooks firmados, parámetros de URL del checkout, el script de UTMs y esta documentación en Markdown), lo que no existe y por dónde empezar.
Esta sección es para quien va a conectar una tienda de Vipter a un sistema propio: un ERP, un CRM, un área de miembros hecha en casa o una base de datos de informes. Las páginas van directo al formato, a los números y al código. Para los pasos en el panel, cada página remite a la versión escrita para el dueño de la tienda.
Lo que existe hoy
| Recurso | Dirección | Para qué sirve | Referencia |
|---|---|---|---|
| Webhooks de salida | Vipter → tu servidor | Un POST en JSON, firmado con HMAC SHA-256, por cada venta, reembolso, cambio de suscripción, cliente nuevo o checkout abandonado. Son 20 tipos de evento, con reintentos automáticos. | Catálogo de eventos, sobre, firma, reintentos |
| Parámetros de URL del checkout | Tu sitio → checkout | Armar enlaces que ya se abren con paquete, cupón, vendedor, idioma, moneda, datos del comprador y origen de la campaña. | Parámetros de URL |
Script t.js | Tu página de ventas → checkout | Llevar UTMs, IDs de clic, cookies de anuncios y el código de vendedor de tu página hasta el enlace del checkout. | Script t.js |
| Documentación en Markdown | Docs → tú o una IA | Cada página de este centro de ayuda existe en Markdown: agrega .md a la dirección. https://docs.vipter.com/llms.txt lista todas las páginas, en todos los idiomas, con el enlace del Markdown. | Esta página en Markdown: https://docs.vipter.com/es/developers/overview.md |
Lo que no existe
- API REST pública y claves de API para dueños de tiendas. No se pueden consultar pedidos, crear clientes, generar cobros ni cambiar suscripciones por API. La comunicación es en un solo sentido: Vipter avisa a tu sistema por webhook, y lo que necesita una acción se hace en el panel.
- Administrar endpoints por código. Los endpoints de webhook se crean, activan, desactivan y quitan solo en el panel.
- Buscar eventos antiguos. Un endpoint recibe los eventos creados mientras existe y está activo. No hay forma de pedir el historial ni de reenviar eventos en lote. El panel reenvía una entrega a la vez, entre las más recientes. Consulta Reintentos, desactivación y reenvío.
- Eventos fuera del catálogo. Solo los 20 tipos del catálogo salen por webhook. No hay evento para PIX (el pago instantáneo de Brasil) generado, pedido pendiente ni carrito en curso.
Por dónde empezar
- Crea un endpoint
https://en GeneralIntegracionesAutomatizacionesWebhooks y guarda el secretowhsec_…, que aparece una sola vez. El paso a paso con capturas está en Recibir eventos en tu sistema. - En tu servidor, lee el cuerpo sin procesar de la solicitud y verifica la firma antes que nada.
- Responde con un código 2xx en hasta 10 segundos y procesa el evento después, en una cola. Una respuesta lenta cuenta como fallo y genera reintentos.
- Guarda el
idde cada evento e ignora los que ya se procesaron. La entrega es "al menos una vez": el mismo evento puede llegar más de una vez. Consulta idempotencia. - Haz clic en Enviar evento de prueba en el panel y revisa en Entregas recientes que tu sistema aceptó la entrega.
Un endpoint por finalidad
Cada endpoint tiene su secreto, su lista de eventos y su cola de entregas. Un fallo en un endpoint no retrasa a los demás. Si dos sistemas reciben eventos, crea un endpoint para cada uno.
Qué hacer después
- Consulta lo que trae cada evento en el catálogo de eventos.
- Arma enlaces de checkout con los parámetros de URL.
- Lleva el origen de las ventas de tu página hasta el checkout con el script t.js.
Hablar con el vendedor
Para quien compró en una tienda que usa Vipter. Dónde encontrar el contacto de la tienda y por qué las dudas sobre el producto, la entrega y el reembolso se resuelven con ella.
Catálogo de eventos
Los 20 tipos de evento que Vipter envía por webhook, cuándo se dispara cada uno y lo que viene en data.object, con un ejemplo completo de pedido, suscripción, cliente y checkout abandonado.