Integrações e migração
Como conectar um checkout e configurar postbacks
Crie uma integração de vendas, instale a URL no checkout, preserve a atribuição e valide o primeiro postback.
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
- No menu principal da Moviie, abra Vendas.
- Selecione Nova integração. Se ainda não houver nenhuma, você também pode usar Começar configuração.
- Em Escolha a plataforma, selecione o seu checkout. Use Webhook genérico, Zapier, Make ou n8n quando precisar definir o contrato do evento.
- Digite um nome que identifique produto ou operação, como “Produto principal”.
- Mantenha o Parâmetro de atribuição sugerido. Altere-o somente quando a configuração do checkout exigir outro campo.
- Informe o segredo solicitado, como Hottok ou Secret Key, quando o campo aparecer.
- 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:
- Abra a área de webhooks, notificações ou postbacks da plataforma.
- Crie uma configuração e cole a URL da Moviie.
- Selecione compra aprovada e renovação. Inclua reembolso e chargeback quando a plataforma oferecer esses eventos.
- Preserve o parâmetro de atribuição indicado pela Moviie na ida ao checkout.
- 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
- Abra Saúde no cartão da integração.
- Confirme que a entrega aparece como Processado.
- Volte a Vendas e confira Atribuição encontrada.
- 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 qualquer plataforma de pagamento
Quando Outra plataforma estiver disponível na sua conta, você pode configurar notificações sem uma integração específica para o gateway. Seu servidor ou automação envia JSON para a Moviie. Integrações antigas continuam usando o mapeamento anterior até uma mudança explícita de configuração.
Escolha Formato padrão para usar os campos order_id, event_type, amount_cents e currency. Esses quatro campos são obrigatórios. O valor é inteiro em centavos e a moeda precisa ser suportada. O exemplo inicial inclui test: true: mantenha essa marcação durante os testes para não contabilizar receita.
Escolha Meu próprio payload para aproveitar seu JSON. Carregue uma amostra fictícia e indique caminhos como sale.id e sale.amount. Moeda e evento podem vir de um caminho ou de um valor fixo explícito. Escolha a unidade do valor e traduza os eventos do seu sistema. Um status desconhecido nunca significa automaticamente compra aprovada. Use um evento fixo de compra aprovada somente quando todas as notificações enviadas forem pagamentos confirmados.
A amostra pode ser colada ou enviada para uma URL temporária, válida por dez minutos e para uma única captura. Ela expira em 24 horas. Amostras e prévias não criam vendas. Confira a prévia e selecione Publicar configuração. Copie a URL para receber vendas e configure requisições POST com JSON no seu servidor ou automação. Essa URL é uma credencial e não deve aparecer no código público do site.
Relacionar a venda com a VSL
Inclua conversion_key no formato padrão ou mapeie Chave da sessão no seu payload. Sem essa chave, a notificação pode ser válida, mas a venda fica sem atribuição à VSL. Em um pagamento embutido, seu código web pode obter a chave do player com getConversionKey() e repassá-la ao servidor junto do pedido. Use a instância do player correspondente à VSL. Se a chave estiver indisponível, não bloqueie o pagamento.
Data do evento, indicação de teste, e-mail e itens são opcionais. Sem data válida da origem, o formato padrão usa a hora de recebimento quando o campo está ausente; uma data enviada em formato inválido precisa ser corrigida. No mapeamento, escolha explicitamente o formato de data. Consulte o guia técnico de integração para campos, moedas e limites.
Reembolsos e contestações
Envie o valor acumulado do reembolso ou da contestação para o mesmo pedido. Se o total reembolsado passou de 30 para 50, envie 50, não apenas os 20 adicionais. A soma de reembolsos e contestações não pode superar a compra. Uma reversão que chega antes da compra aguarda o registro original; ela usa a atribuição dessa compra.
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
Continue por aqui
Guias que ajudam no próximo passo.