Status da venda
Cada venda carrega dois status, e eles respondem perguntas diferentes. Confundir os dois é o erro que mais produz número errado.
| Campo | Responde |
|---|---|
eventStatus | o gateway considera essa venda paga? |
status | o PassKey conseguiu disparar a conversão para o pixel? |
Para faturamento, use eventStatus. O status é diagnóstico do disparo — uma venda paga com status FAILED é dinheiro que entrou e pixel que não recebeu.
eventStatus
É o vocabulário do gateway, repassado como veio: paid, refunded, waiting, failed e o que mais o gateway usar. É string livre de propósito — gateway novo pode trazer valor próprio, e isso não pode quebrar a sua leitura.
Trate valor desconhecido como "não sei", nunca como "não pago". Um else que assume não-pago transforma gateway novo em faturamento perdido.
status
| Valor | O que houve |
|---|---|
RECEIVED | chegou, ainda não processado |
PROCESSED | normalizado e gravado |
DISPATCHED | conversão enviada ao pixel |
FAILED | o envio ao pixel falhou |
DUPLICATE | o gateway reenviou algo que já tínhamos |
IGNORED | não era pagamento (ex.: estorno), então não há disparo |