Referência técnica
Códigos de resposta do postback
O que cada status significa para quem está integrando.
Toda resposta é JSON. Repare que duplicata devolve 200, de propósito: erro faria a plataforma entrar em loop de retry.
| HTTP | status | Significado |
|---|---|---|
| 200 | created | Conversão registrada. Devolve conversion_id e event. |
| 200 | duplicate | Já registrado. A conversão existente nunca é sobrescrita. |
| 200 | orphan | Workspace reconhecido, identificador desconhecido. |
| 200 | unmatched | Sem token e sem clique conhecido. |
| 400 | invalid | Nenhum parâmetro de tracking reconhecido. |
| 401 | unauthorized | Token ausente ou inválido. |
| 403 | forbidden | IP fora da allowlist do merchant. |
200 · created
{
"status": "created",
"event": "SALE",
"conversion_id": "f9d7a7a6-1246-42ea-9534-83764dc66b82"
}Idempotência
Cada conversão recebe uma chave derivada de workspace, merchant, clique e tipo, mais o
identificador externo ou um balde de tempo. Reenvio com a mesma chave devolve
duplicate. Mandar transaction_id é a forma mais confiável de
garantir isso.