Todo PIX que entra vira um recurso received, com ou sem cobrança:
  • Veio de uma cobrança sua: charge_id, external_id e metadata vêm preenchidos.
  • Veio direto na chave: esses três vêm null. Identifique o cliente pelo payer.
  • refundable_amount é quanto ainda dá para devolver.
  • amount é o valor bruto creditado. Tarifas, quando houver, aparecem como linhas próprias no extrato (pix_fee).
Evento: pix.received (sempre) e, se for de cobrança, também charge.paid.