Pular para o conteúdo principal

Evento transaction.created

Disparado quando um lançamento nasce no extrato: cada parcela de uma venda confirmada, o débito de um estorno, um ajuste. Numa venda parcelada, um evento por parcela por beneficiário. O data.object usa o mesmo shape de GET /v1/transactions/:id. Movimentos de saída (estornos) têm amount e net_amount negativos — somar os eventos de um período é somar o extrato.

Como processar

  • Registre o id do evento (evt_*) para processar de forma idempotente.
  • Use data.object.id (txn_*) como chave do lançamento no seu sistema.
  • Relacione o movimento à venda por payment_intent e ao causador por source.
O exemplo de venda mostra R$ 1.000,00 com taxa de R$ 39,90 e incentivo de cartão de R$ 5,00. O total de taxas é R$ 34,90 e o líquido é R$ 965,10.

Payload