# Cómo resolver errores de postback y atribución

> Usa la salud de la integración para saber por qué una entrega falló, fue rechazada o no encontró la sesión del video.

- Canonical: https://moviie.ai/help/es/problemas/resolver-errores-de-postback-y-atribucion
- Language: es
- Category: Solución de problemas
- Published: 2026-08-11
- Updated: 2026-08-11

Abre **Ventas**, encuentra la integración y selecciona **Salud**. La página muestra la última entrega, la tasa de atribución, las firmas rechazadas y los fallos que requieren revisión.

## Entender cada estado

Estado

Qué significa

Qué hacer

**Recibido**

La entrega llegó y espera ser procesada.

Actualiza la página después de unos instantes.

**Procesado**

El evento fue validado y normalizado.

Si la venta no aparece, revisa la atribución, el tipo de evento y el período.

**Sin atribución**

El evento es válido, pero no se vinculó a una sesión.

Revisa el parámetro de atribución y la URL usada para el checkout.

**Firma rechazada**

El secreto recibido no coincide con la integración.

Copia de nuevo Hottok, Secret Key o el secreto del webhook.

**Evento no compatible**

El estado enviado no corresponde a un evento conocido.

Ajusta los eventos en el checkout o el mapa de eventos.

**Falló**

El contenido de la entrega no pudo procesarse.

Abre el error mostrado y revisa valores, moneda y mapeo.

**Ignorado**

La entrega llegó mientras la integración estaba pausada.

Reactívala antes de enviar otra prueba o evento.

## Si no aparece ningún postback

Confirma que la integración está activa.

Compara la URL del checkout con la que muestra Moviie.

Revisa que el evento de compra aprobada esté seleccionado en la plataforma.

Usa la prueba del checkout, no solo la acción **Probar** de Moviie.

Vuelve a **Salud** y selecciona **Actualizar**.

Si giraste la URL, sustituye la dirección en el checkout. La URL anterior funciona durante 48 horas y después deja de recibir eventos.

## Si la firma fue rechazada

El secreto guardado en Moviie debe coincidir con el que usa la plataforma para firmar la entrega. No uses la contraseña de tu cuenta ni una clave de API destinada a otra función.

Crea una nueva integración cuando necesites sustituir un secreto que no puede editarse en la pantalla. Prueba la URL nueva antes de eliminar la integración anterior.

## Si la venta quedó sin atribución

Un postback puede procesarse y aun así quedar fuera del embudo. Esto ocurre cuando:

el checkout no devolvió el parámetro de atribución;

la clave llegó en un campo distinto del configurado;

la URL de la CTA ya contenía otro valor en el mismo parámetro;

la compra ocurrió más de 30 días después de crear la clave;

la clave pertenece a otra organización o no corresponde a una sesión válida;

la sesión se identificó como robot o el evento se marcó como prueba.

Abre la tarjeta de la integración y revisa el nombre del parámetro. En integraciones propias, revisa también el campo **Clave Moviie** en Mapeo.

## Si el evento no es compatible

Para Webhook genérico, Zapier, Make y n8n, abre **Mapeo**. Revisa la ruta de **Tipo/estado del evento** y el **Mapa de eventos**.

Los destinos aceptados son `purchase_approved`, `payment_pending`, `purchase_refused`, `refund`, `chargeback`, `subscription_renewed`, `checkout_abandoned`, `test` y `unsupported`.

Un estado sin correspondencia sigue visible en Salud, pero no entra en el embudo ni en los ingresos.

## Corregir antes de interpretar el embudo

Usa **Atribución encontrada** como señal de calidad de la conexión. Una tasa baja indica que algunos eventos llegaron sin vínculo con el video. La tasa de venta por reproducción queda incompleta en ese caso.

Los postbacks permanecen disponibles para replay durante 180 días. Después de corregir un mapeo, contacta con support\@moviie.ai si necesitas reprocesar el historial elegible.

Al solicitar ayuda, incluye el nombre de la integración, la plataforma, la hora aproximada de la entrega y el estado mostrado. No envíes datos personales del comprador ni el secreto de firma.

## Sigue aprendiendo

Cómo conectar un checkout y configurar postbacks de ventas

Cómo seguir el embudo de ventas por video
