Skip to main content
Os eventos transparent.* avisam os pagamentos, reembolsos e disputas das cobranças do checkout transparente, criadas pela API sem passar pela página de pagamento. A entrega, as retentativas e a verificação estão em Webhooks. Em data chegam:
  • transparent: a cobrança, com o link do comprovante em receiptUrl e o seu metadata.
  • customer: o cliente, com o CPF ou CNPJ mascarado.
  • payerInformation: o método usado (PIX, CARD ou BOLETO), as UTMs e quem pagou.
  • reason: só no transparent.refunded e no transparent.disputed.
Disparado quando a cobrança é paga. Pix e boleto chegam com status: "PAID", e cartão com status: "APPROVED".

Cartão: o que muda

  • O status de pago é APPROVED. Depois, quando o valor é liquidado, a cobrança passa a PAID sem novo webhook.
  • Uma venda, um evento. Na venda parcelada chega um único transparent.completed, com o id da primeira parcela, amount com o total da venda e os campos installmentCount, installmentAmount, installmentNumber e installmentGroupId. A taxa é calculada sobre a venda inteira e dividida entre as parcelas, e o platformFee do evento é a parte da primeira parcela. Veja Parcelamento no cartão.
  • Repasse de taxa: amount traz o total pago pelo cliente, e customerFee traz o acréscimo. Veja Repasse de taxa.
  • Bandeira e final do cartão ficam em payerInformation.CARD (brand e number).
  • O cardToken não vem no webhook. Guarde o que volta na resposta de Criar cobrança no cartão ou consulte a cobrança pela API.