Integraciones y migración
Cómo conectar un checkout y configurar postbacks
Crea una integración de ventas, instala su URL en el checkout, conserva la atribución y valida el primer postback.
Conecta el checkout para que cada compra confirmada vuelva a Moviie y pueda vincularse al video que participó en la venta. La integración usa una URL exclusiva y, cuando la plataforma lo exige, un secreto de firma.
Antes de comenzar
Necesitas acceso a la configuración de webhooks o postbacks del checkout. Confirma también que la CTA del video apunta a la página de pago usada en esta integración.
Cuando hay una integración activa, Moviie añade una clave de atribución a una URL compatible del checkout. No sobrescribe un valor que ya exista en el mismo parámetro.
Crear la integración
- Abre Ventas en el menú principal de Moviie.
- Selecciona Nueva integración. Si todavía no existe ninguna, también puedes usar Comenzar configuración.
- En Elige la plataforma, selecciona tu checkout. Usa Webhook genérico, Zapier, Make o n8n cuando necesites definir el contrato del evento.
- Escribe un nombre que identifique el producto o la operación, como “Producto principal”.
- Conserva el Parámetro de atribución sugerido. Cámbialo solo si la configuración del checkout exige otro campo.
- Introduce el secreto solicitado, como Hottok o Secret Key, cuando aparezca el campo.
- Selecciona Crear integración y esperar prueba.
Moviie genera la URL exclusiva después de la creación.
Configurar el postback en el checkout
Copia la URL del postback desde la tarjeta de la integración. Después:
- Abre el área de webhooks, notificaciones o postbacks de la plataforma.
- Crea una configuración y pega la URL de Moviie.
- Selecciona compra aprobada y renovación. Incluye reembolso y chargeback cuando la plataforma ofrezca esos eventos.
- Conserva el parámetro de atribución de Moviie en el recorrido hacia el checkout.
- Guarda la configuración.
La pantalla Conectar checkout ofrece instrucciones específicas para la plataforma y abre su documentación oficial cuando hay una guía disponible.
Ejecutar las dos pruebas
Selecciona Probar en la tarjeta de la integración. Esta prueba confirma que la URL interna recibe el evento y valida la firma de Moviie. El evento queda visible en Salud, pero nunca entra en el embudo ni en los ingresos.
Después envía una prueba desde el propio checkout. Esta segunda prueba valida el recorrido externo, incluida la URL, el secreto y los eventos seleccionados. Si la plataforma no ofrece una acción de prueba, usa una transacción controlada y confirma el resultado antes de considerar lista la integración.
Confirmar la primera venta atribuida
- Abre Salud en la tarjeta de la integración.
- Confirma que la entrega aparece como Procesado.
- Vuelve a Ventas y revisa Atribución encontrada.
- Abre Embudo por video para encontrar la venta y los ingresos en el período correcto.
Una compra solo entra en el embudo cuando fue aprobada, llegó dentro de la ventana de 30 días y trajo la clave de atribución de una sesión válida.
Usar cualquier plataforma de pago
Cuando Otra plataforma esté disponible en tu cuenta, tu servidor o automatización puede enviar JSON sin una integración específica para el gateway. Las integraciones anteriores mantienen su mapeo hasta un cambio explícito de configuración.
Elige el formato estándar para enviar order_id, event_type, amount_cents y currency. Los cuatro campos son obligatorios. El importe es un entero en unidades menores y la moneda debe ser compatible. El ejemplo inicial incluye test: true: conserva esta marca durante las pruebas para no contabilizar ingresos.
Elige tu propio payload para reutilizar tu JSON. Carga una muestra ficticia e indica rutas como sale.id y sale.amount. La moneda y el evento pueden usar una ruta o un valor fijo explícito. Selecciona la unidad del importe y traduce los eventos de tu sistema. Un valor desconocido nunca significa automáticamente pago aprobado. Usa un evento fijo de compra aprobada solo si todas las notificaciones representan pagos confirmados.
Pega una muestra o envíala a una URL temporal, válida durante diez minutos y para una sola captura. La muestra caduca a las 24 horas. Las muestras y vistas previas no crean ventas. Revisa la vista previa y publica la configuración. Copia la URL para recibir ventas y configura solicitudes POST con JSON desde tu servidor. La URL es una credencial: no la incluyas en el código público del sitio.
Relacionar la venta con la VSL
Incluye conversion_key en el formato estándar o mapea la clave de sesión en tu payload. Sin ella, una venta válida puede quedar sin atribución a la VSL. Para pagos embebidos, el código web puede obtener la clave de la instancia correspondiente del reproductor con getConversionKey() y enviarla al servidor con el pedido. No bloquees el pago si la clave no está disponible.
La fecha del evento, la marca de prueba, el correo y los artículos son opcionales. Si falta la fecha, se usa la hora de recepción; una fecha enviada en formato inválido debe corregirse. En el mapeo, selecciona explícitamente el formato de fecha. Consulta la guía técnica de integración para campos, monedas y límites.
Reembolsos y contracargos
Envía el importe acumulado reembolsado o disputado para el mismo pedido. Si el total reembolsado pasa de 30 a 50, envía 50, no los 20 adicionales. La suma de reembolsos y contracargos no puede superar la compra. Una reversión recibida antes de su compra espera el registro original y usa su atribución.
Pausar, girar o eliminar la integración
- Pausar conserva la configuración, pero las entregas nuevas se ignoran hasta reactivarla.
- Girar URL crea una nueva dirección. La URL anterior sigue aceptándose durante 48 horas para actualizar el checkout sin interrumpir la recopilación.
- Eliminar detiene las entregas nuevas. Las ventas y postbacks ya registrados permanecen en el historial.
No publiques la URL exclusiva ni compartas el secreto de firma.
Sigue aprendiendo
Continúa por aquí
Guías que ayudan con el próximo paso.