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

- Canonical: https://moviie.ai/help/pt-br/integracoes/conectar-checkout-e-configurar-postbacks-de-vendas
- Language: pt-BR
- Category: Integrações e migração
- Published: 2026-08-11
- Updated: 2026-10-23

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

Como acompanhar o funil de vendas por vídeo

Como resolver erros de postback e atribuição
