Rastreamento S2S por postback: checklist de integração
Preserve IDs de atribuição, trate duplicidades e mudanças de status e comprove a entrega com um teste repetível.

Preserve a identidade do clique à conversão
Um postback servidor a servidor informa uma conversão de um backend a outro. Ele ainda precisa de um vínculo de atribuição. Capture o ID de clique ou transação da plataforma no ponto de entrada combinado e guarde-o com o lead ou pedido antes de redirecionamentos, callbacks ou atualizações no CRM. O postback não recria um identificador perdido pelo seu sistema.
Mapeie ID de clique, seu ID da conversão comercial, oferta, evento, status, valor, moeda e horário do evento. Separe comissão de valor do pedido. Everflow documenta IDs de transação criados no clique; Affise diferencia clickid e action_id. Use os parâmetros e regras de codificação reais de cada destinatário, sem presumir um esquema universal.
Defina eventos, mudanças de status e duplicidades
Combine o significado de envio, aprovação, rejeição, retenção e pagamento nesta integração. Os status da plataforma não correspondem automaticamente às etapas do CRM. Defina quais transições criam ou atualizam a conversão ou mudam o valor remunerável. Documente aprovações tardias, estornos e mensagens fora de ordem; um lead recebido não é necessariamente aprovado ou remunerável.
Defina um identificador estável para o evento comercial e as regras de deduplicação do destinatário. Reenviar o mesmo evento não deve gerar outra comissão; uma compra repetida legítima precisa ser distinguível. Teste esses casos. Não trate uma atualização de status como nova venda nem descarte uma rejeição posterior porque o ID de conversão já existe.
Torne a entrega observável e recuperável
Use endpoints HTTPS autenticados e mantenha segredos fora de URLs públicas e logs rotineiros. Confirme timeout, resposta de sucesso e comportamento de novas tentativas com cada remetente e destinatário. No seu próprio processo de envio, persista o evento, limite tentativas com intervalos crescentes para falhas transitórias e destaque tentativas esgotadas para conciliação. Corrija erros permanentes de validação antes de reenviar.
Logs mínimos úteis incluem horários UTC de recebimento e evento, IDs de correlação e conversão, oferta, evento, status, valor e moeda, número da tentativa, resposta HTTP e resultado da validação. Oculte credenciais e dados pessoais desnecessários. Sucesso HTTP sozinho não comprova atribuição: examine a conversão registrada e seu status no relatório de destino.
Teste a jornada completa e concilie
Teste um caminho válido de clique a lead e aprovação, IDs ausentes ou malformados, entrega duplicada, reversão de status, oferta ou evento errados, conversão atrasada e falha temporária do endpoint. Compare um evento comercial esperado com um resultado registrado e o valor correto. Concilie fonte, rastreador e CRM pela mesma coorte e fuso antes de ampliar os gastos.
A documentação de Affise e Everflow sustenta os exemplos de plataforma. Sales Machine é uma ficha relacionada de CRM de leads com demonstração privada; o comportamento de sua integração em produção não foi verificado neste guia. Peça uma demonstração de armazenamento de IDs, mapeamento de status, tentativas e exportações usando este checklist antes de considerar o fluxo confirmado.