Skip to main content
The payment.fee_refunded event is sent when a fee associated with a payment has been successfully refunded. This event applies only to the refunded fee amount and does not affect the original payment status.

Example Payload

{
  "event": "payment.fee_refunded",
  "id": "a550ba77-09ac-4bc7-9d5b-505a5135f3b6",
  "data": {
    "payment_id": "a550ba77-09ac-4bc7-9d5b-505a5135f3b6",
    "status": "success",
    "amount": 10.0,
    "refund_transaction_id": "4f2f7785-d5d0-4202-a95f-af4968535775"
  },
  "eventGeneratedTime": 1756729948.128641
}

Data Fields

payment_id
string
Unique identifier of the original payment.
status
string
Refund status. Always success for this event.
amount
float
Refunded fee amount represented as a decimal in the transaction currency.
refund_transaction_id
string
Unique identifier for the fee refund transaction.

Handling the Event

Use this event to:
  • Record refunded fees linked to a payment
  • Update accounting or reconciliation records
  • Synchronize refund activity across systems
  • Track fee-level adjustments independently of payment status