Status, valor e moeda da conversão
Os quatro status aceitos e o que cada um faz com a receita, como o payout é lido e convertido, e como tratar estorno, boleto pendente e vendas em outra moeda.
Status
O postback pode informar o status da transação em status (ou status_conversao). Valores aceitos:
| Status | Significado | Efeito na receita |
|---|---|---|
approved | Pagamento confirmado | Conta |
pending | Aguardando pagamento (boleto, Pix não pago) | Gravada, não conta até virar approved |
declined | Recusada / cancelada | Não conta |
refunded | Estornada | Deixa de contar; a conversão fica marcada como estornada |
Qualquer outro valor — inclusive ausência do parâmetro — é tratado como approved. Se a sua plataforma manda status em outro vocabulário (paid, complete, chargeback), um Merchant com regras traduz para esses quatro. Veja Merchants.
Ciclo de vida pelo txid
Um mesmo txid pode chegar várias vezes com status diferentes, e é assim que a conversão acompanha a transação:
txid=ABC status=pending → conversão criada, pendente
txid=ABC status=approved → mesma conversão, aprovada, receita conta
txid=ABC status=refunded → mesma conversão, estornada, receita saiO que não muda numa repetição é o valor e o tipo: a primeira gravação vale. Diferenças de valor em reenvios ficam registradas em Logs › Postbacks S2S como duplicate com o motivo.
Valor (payout)
Lido de payout (ou valor, amount, sum, value). Regras:
- Ponto como separador decimal:
97.00. Valor com vírgula ou com símbolo de moeda não é um número válido e pode ser gravado como zero — confira no payload do log o que a plataforma realmente envia. - Sem símbolo de moeda, sem separador de milhar.
- Sem valor, a conversão é gravada com
0— aparece em Conversões, mas não gera receita. - O valor entra na receita somente se o tipo conta receita.
Muitas plataformas oferecem duas macros: o valor da venda e a comissão. Escolha a que representa a sua receita: para afiliado, a comissão; para produtor, o valor bruto ou líquido.
Moeda
Lida de currency (ou moeda), no código ISO de três letras (BRL, USD, EUR). Sem o parâmetro, assume a moeda do workspace (Configurações). O painel exibe tudo na moeda do workspace; conversões em outra moeda são armazenadas com a moeda original.
Casos práticos
Boleto. A plataforma manda pending na emissão e approved na compensação. Configure os dois eventos para o mesmo endpoint, com o mesmo txid. A receita só entra na compensação — e o relatório do dia da compra pode mudar dias depois.
Estorno. Configure o evento de reembolso da plataforma com status=refunded e o mesmo txid. A conversão passa a estornada, a receita do dia cai, e o destino de conversão não manda um novo evento para a plataforma de anúncios (não há evento de "des-compra" na Meta nem no Google).
Carrinho com vários itens. Um txid por pedido, com o valor total. Se a plataforma manda um postback por item com o mesmo txid, só o primeiro conta — use repeated com txid por item se quiser todos.
Parcelado. A venda conta uma vez, pelo valor total, no approved. Parcelas não são eventos.