Skip to main content
When Plane returns funds back to your company, we will do that through a Refund object. You can think of refunds as inverse charges, or as a Payment where the recipient is your company, not one of your workers. Refunds are most commonly used when you create a Payment and subsequently cancel it, after the Charge linked to that Payment already started to process.

Attributes

id
string
Unique identifier for the refund.
date
string
Date the refund was created or scheduled.
amount
string
Amount returned to your company in decimal format.
currency
string
Three-letter ISO currency code, in uppercase.
reference
string
Optional reference attached to the refund.
note
string
Optional memo attached to the refund.
status
string
Current refund status, such as draft, pending, succeeded, or failed.
source
string
The ID of the funding source connected to the refund.
entity
string
The ID of the legal entity receiving the refund.
{
  "id": "re_1PqJvEf9iWm3mK7P2fZp9Qxc",
  "date": "2025-08-15",
  "amount": "1000.00",
  "currency": "USD",
  "reference": "RF-2025-0815",
  "note": "Cancelled contractor payment",
  "status": "succeeded",
  "source": "src_4a8S6Cm7qN9xL2eP",
  "entity": "ent_7Vu2fTc0bL3kQ9mR"
}