Ler os logs de postback (resultado, motivo, payload)
O que cada coluna de Logs › Postbacks S2S significa, como usar os filtros, o que o payload revela, quanto tempo os logs ficam e como consultá-los pela API.
Logs › Postbacks S2S é o registro de auditoria de tudo o que chegou ao endpoint de postback do workspace. Aceito ou recusado, com token ou sem, cada requisição vira uma linha.
As colunas
| Coluna | Conteúdo |
|---|---|
| Recebido | Data e hora no fuso do workspace. |
| Resultado | created, duplicate, orphan, unmatched, unauthorized, invalid, forbidden. Veja Respostas do postback. |
| HTTP | O código devolvido à plataforma. 200 para aceitos e para não-erros (duplicate, orphan, unmatched); 400, 401, 403 para erros. |
| Click ID | O identificador de clique lido do postback, ou o valor bruto recebido quando não é um click_id válido. |
| Latência | Tempo de processamento em milissegundos. Inclui a gravação, não inclui os envios para destinos (que são assíncronos). |
| Motivo | Explicação do resultado: txid já registrado, tracking não encontrado e sem token de workspace, macro não substituída, IP fora da allowlist… |
| payload | Abre o conteúdo exato da requisição: método, parâmetros de query, corpo (JSON ou form) e cabeçalhos relevantes. |
Filtros
No topo: todos, created, duplicate, orphan, unauthorized, invalid. Combine com a busca por click_id ou txid para acompanhar uma transação específica ao longo dos reenvios da plataforma (pending → approved → refunded aparecem como três linhas).
O que procurar no payload
- O nome do parâmetro do identificador. Se a plataforma mandou
sck=034U7a…e o resultado foicreated, o alias funcionou. Se mandoucodigo_rastreio=034U7a…e deuinvalid, o nome não é reconhecido — Merchant. - Macros não substituídas:
{click_id},{SCK},[SRC]literais. - Valor e formato:
97,00,R$ 97,97.00. - Status e tipo no vocabulário da plataforma, para montar regras.
- IP de origem, para allowlist.
Retenção e volume
Os logs ficam disponíveis no painel por período rolante; a lista mostra os mais recentes primeiro. Para arquivar, exporte pela API.
Pela API
GET /api/logs com os filtros result (created, duplicate, orphan, unauthorized, invalid), q (busca por click_id/txid) e limit. Cada item devolve os mesmos campos da tela, com o payload completo. Útil para alertas: um job que consulta result=invalid a cada hora e avisa quando aparecer algo pega macros quebradas no mesmo dia.
GET /api/orphans lista as conversões órfãs separadamente. Veja Conversões órfãs.
Relação com os outros logs
- Cliques — se o
click_iddo postback não está lá, o postback vai darorphan. - Conversões — só o que deu
created(e as mudanças de status viaduplicate) aparece aqui. - Integrações CAPI › Envios recentes — o que aconteceu depois do
created, no envio para Meta/Google.