# Como resolver erros de postback e atribuição

> Use a saúde da integração para descobrir por que uma entrega falhou, foi rejeitada ou não encontrou a sessão do vídeo.

- Canonical: https://moviie.ai/help/pt-br/problemas/resolver-erros-de-postback-e-atribuicao
- Language: pt-BR
- Category: Solução de problemas
- Published: 2026-08-11
- Updated: 2026-10-23

Abra **Vendas**, localize a integração e selecione **Saúde**. A página mostra a última entrega, a taxa de atribuição, as assinaturas rejeitadas e as falhas que precisam de revisão.

## Entender cada estado

Estado

O que significa

O que fazer

**Recebido**

A entrega chegou e aguarda processamento.

Atualize a página depois de alguns instantes.

**Processado**

O evento foi validado e normalizado.

Se a venda não aparece, confira atribuição, tipo do evento e período.

**Sem atribuição**

O evento é válido, mas não foi ligado a uma sessão.

Confira o parâmetro de atribuição e a URL usada no checkout.

**Assinatura rejeitada**

O segredo recebido não confere com a integração.

Copie novamente Hottok, Secret Key ou segredo do webhook.

**Evento não suportado**

O status enviado não corresponde a um evento conhecido.

Ajuste os eventos no checkout ou o mapa de eventos.

**Falhou**

O conteúdo da entrega não pôde ser processado.

Abra o erro exibido e revise valores, moeda e mapeamento.

**Ignorado**

A entrega chegou enquanto a integração estava pausada.

Reative a integração antes de enviar outro teste ou evento.

## Se nenhum postback aparece

Confirme que a integração está ativa.

Compare a URL configurada no checkout com a URL exibida na Moviie.

Verifique se o evento de compra aprovada está selecionado na plataforma.

Use o teste do checkout, não apenas o botão **Testar** da Moviie.

Volte a **Saúde** e selecione **Atualizar**.

Se você girou a URL, substitua o endereço no checkout. A URL anterior funciona por 48 horas e depois deixa de receber eventos.

## Se a assinatura foi rejeitada

O segredo salvo na Moviie deve ser o mesmo usado pela plataforma para assinar a entrega. Não use a senha da conta nem uma chave de API que pertença a outro recurso.

Crie uma nova integração quando precisar substituir um segredo que não pode ser editado na tela. Depois teste a nova URL antes de remover a anterior.

## Se a venda ficou sem atribuição

Um postback pode ser processado e ainda assim ficar fora do funil. Isso acontece quando:

o checkout não devolveu o parâmetro de atribuição;

a chave chegou em um campo diferente do configurado;

a URL da CTA já tinha outro valor no mesmo parâmetro;

a compra aconteceu mais de 30 dias depois da criação da chave;

a chave pertence a outra organização ou não corresponde a uma sessão válida;

a sessão foi identificada como robô ou o evento foi marcado como teste.

Abra o cartão da integração e confira o nome do parâmetro. Em integrações próprias, revise também o campo **Chave Moviie** no mapeamento.

## Se o evento não é suportado

Para Webhook genérico, Zapier, Make e n8n, abra **Mapeamento**. Confira o caminho de **Tipo/status do evento** e o **Mapa de eventos**.

No mapeamento anterior, os destinos aceitos são: `purchase_approved`, `payment_pending`, `purchase_refused`, `refund`, `chargeback`, `subscription_renewed`, `checkout_abandoned`, `test` e `unsupported`.

Um status sem correspondência continua visível na saúde, mas não entra no funil ou na receita.

## Corrigir antes de interpretar o funil

Use **Atribuição encontrada** como sinal de qualidade da conexão. Uma taxa baixa indica que parte dos eventos chegou sem vínculo com o vídeo. Nesse cenário, a taxa de venda por play fica incompleta.

O conteúdo das entregas pode ser retido por até 180 dias. Esse prazo não torna toda entrega elegível para reprocessamento. Nas integrações antigas, entre em contato com support\@moviie.ai para avaliar o histórico elegível depois de corrigir o mapeamento.

Ao pedir ajuda, envie o nome da integração, a plataforma, o horário aproximado da entrega e o estado mostrado na tela. Não envie dados pessoais do comprador nem o segredo de assinatura.

## Diagnosticar uma integração universal

Receber a requisição, interpretar os campos e atribuir a venda são resultados diferentes. Uma resposta de recebimento com `receiptId` confirma a entrega, não uma venda no funil. Confira o resultado em **Saúde**. Uma prévia que encontra a chave também não comprova uma venda real.

**Erro na interpretação**: revise os campos obrigatórios, caminhos, unidade do valor, moeda e tradução do evento. Carregue outra amostra se ela expirou.

**Teste processado**: a entrega foi tratada como teste e não criou receita. Uma venda real precisa chegar sem a marcação de teste.

**Notificação repetida** ou **Atualização antiga ignorada**: reenviar não cria outra venda nem substitui dados mais recentes.

**Dados conflitantes**: confira pedido, moeda, chave, data da origem e total de reversões. Não altere o identificador do pedido para contornar a proteção contra duplicatas.

**Aguardando compra original**: envie a compra correspondente. A reversão será reavaliada automaticamente enquanto o conteúdo estiver retido.

Publicar uma correção não reinterpreta silenciosamente as entregas anteriores. Quando uma entrega com falha for elegível, abra sua prévia em **Saúde**, confira o resultado e confirme o reprocessamento. Ele pode registrar uma venda real. Entregas de teste, já normalizadas, truncadas, expiradas ou sem conteúdo retido não são elegíveis. A retenção de até 180 dias é um limite, não uma garantia de reprocessamento de qualquer evento.

Se houver conflito de versão, recarregue a configuração antes de tentar novamente. Para suporte, informe o identificador da entrega, o horário e o estado. Não envie payloads com dados pessoais, chaves ou URLs de recebimento.

## Continue aprendendo

Como conectar um checkout e configurar postbacks

Como acompanhar o funil de vendas por vídeo
