Como conectar um checkout e configurar postbacks

Conecte o checkout para que cada compra confirmada possa voltar à Moviie e ser ligada ao vídeo que participou da venda. A integração usa uma URL exclusiva e, quando a plataforma exigir, um segredo de assinatura.

Antes de começar

Você precisa de acesso às configurações de webhook ou postback do checkout. Também confirme que a CTA do vídeo aponta para a página de pagamento usada nessa integração.

Quando existe uma integração ativa, a Moviie acrescenta uma chave de atribuição à URL compatível do checkout. O parâmetro já preenchido na URL não é sobrescrito.

Criar a integração

1. No menu principal da Moviie, abra Vendas.
2. Selecione Nova integração. Se ainda não houver nenhuma, você também pode usar Começar configuração.
3. Em Escolha a plataforma, selecione o seu checkout. Use Webhook genérico, Zapier, Make ou n8n quando precisar definir o contrato do evento.
4. Digite um nome que identifique produto ou operação, como “Produto principal”.
5. Mantenha o Parâmetro de atribuição sugerido. Altere-o somente quando a configuração do checkout exigir outro campo.
6. Informe o segredo solicitado, como Hottok ou Secret Key, quando o campo aparecer.
7. Selecione Criar integração e aguardar teste.

A Moviie gera a URL exclusiva depois da criação.

Configurar o postback no checkout

No cartão da integração, copie a URL do postback. Depois:

1. Abra a área de webhooks, notificações ou postbacks da plataforma.
2. Crie uma configuração e cole a URL da Moviie.
3. Selecione compra aprovada e renovação. Inclua reembolso e chargeback quando a plataforma oferecer esses eventos.
4. Preserve o parâmetro de atribuição indicado pela Moviie na ida ao checkout.
5. Salve a configuração.

A tela Conectar checkout mostra instruções próprias para a plataforma escolhida e abre a documentação oficial quando houver um guia disponível.

Fazer os dois testes

No cartão da integração, selecione Testar. Esse teste confirma que a URL interna recebe o evento e valida a assinatura usada pela Moviie. O evento fica visível na saúde, mas não entra no funil nem na receita.

Depois envie também um teste pelo próprio checkout. Esse segundo teste valida o caminho externo, incluindo URL, segredo e seleção de eventos. Se a plataforma não tiver um botão de teste, use uma transação controlada e confirme o resultado antes de considerar a integração pronta.

Confirmar a primeira venda atribuída

1. Abra Saúde no cartão da integração.
2. Confirme que a entrega aparece como Processado.
3. Volte a Vendas e confira Atribuição encontrada.
4. Abra Funil por vídeo para localizar a venda e a receita no período correto.

Uma compra só aparece no funil quando foi aprovada, chegou dentro da janela de 30 dias e trouxe a chave de atribuição de uma sessão válida.

Usar um webhook próprio

Em Webhook genérico, Zapier, Make e n8n, abra Mapeamento para indicar onde o payload traz pedido, evento, valor, moeda, chave Moviie e data. Você também precisa associar os status do seu sistema aos eventos aceitos pela Moviie.

Cada salvamento cria uma nova versão do mapeamento. Valide uma entrega real antes de usar os números para tomar decisões.

Pausar, girar ou remover a integração

• Pausar mantém a configuração, mas as novas entregas ficam ignoradas até a reativação.
• Girar URL cria um novo endereço. A URL anterior continua aceita por 48 horas para você atualizar o checkout sem interromper a coleta.
• Remover encerra novas entregas. As vendas e postbacks já registrados permanecem no histórico.

Não publique a URL exclusiva nem compartilhe o segredo de assinatura.

Continue aprendendo

• Como acompanhar o funil de vendas por vídeo
• Como resolver erros de postback e atribuição