Skip to main content
The payment.refund event is sent when a payment amount has been successfully refunded and the refund process has completed. This event represents a completed refund transaction associated with an existing payment.

​
Example Payload

{
  "event": "payment.refund",
  "id": "a70f3889-7a4f-4ec0-a3c0-652fdfa323db",
  "data": {
    "payment_id": "a70f3889-7a4f-4ec0-a3c0-652fdfa323db",
    "status": "completed",
    "amount": 1000.0,
    "refund_transaction_id": "539d185f-8586-4714-bde5-351a6c38a191"
  },
  "eventGeneratedTime": 1756731284.557921
}

​
Data Fields

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

​
Handling the Event

Use this event to:
  • Record completed refund transactions
  • Update balances or accounting records
  • Synchronize refund state across systems
  • Track refunded amounts independently of payment execution