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

- Canonical: https://moviie.ai/help/es/integraciones/conectar-checkout-y-configurar-postbacks-de-ventas
- Language: es
- Category: Integraciones y migración
- Published: 2026-08-11
- Updated: 2026-08-11

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 un webhook propio

En **Webhook genérico**, Zapier, Make y n8n, abre **Mapeo** para indicar dónde están el pedido, evento, importe, moneda, clave Moviie y fecha en el payload. También debes asociar los estados de tu sistema con los eventos aceptados por Moviie.

Cada guardado crea una nueva versión del mapeo. Valida una entrega real antes de usar los datos para tomar decisiones.

## 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

Cómo seguir el embudo de ventas por video

Cómo resolver errores de postback y atribución
