# 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-08-11

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