Pular para o conteúdo
Moviie

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.

Atualizado em 23 de outubro de 20265 min de leitura

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

SUPORTE HUMANO

Ainda precisa de ajuda?

Conte o que está acontecendo. Nossa equipe ajuda você a encontrar o próximo passo.