<- Object

Object

All versions ->

Refund

Represents a refund processed for a Square transaction.

Link to section

Properties

Link to section

id

string

Required

The refund's unique ID.

Max Length
255
Link to section

location_id

string

Required

The ID of the refund's associated location.

Max Length
50
Link to section

transaction_id

string

The ID of the transaction that the refunded tender is part of.

Max Length
192
Link to section

tender_id

string

Required

The ID of the refunded tender.

Max Length
192
Link to section

created_at

string

Read only The timestamp for when the refund was created, in RFC 3339 format.

Examples for January 25th, 2020 6:25:34pm Pacific Standard Time:

UTC: 2020-01-26T02:25:34Z

Pacific Standard Time with UTC offset: 2020-01-25T18:25:34-08:00

Max Length
32
Link to section

reason

string

Required

The reason for the refund being issued.

Max Length
192
Link to section

amount_money

Required

The amount of money refunded to the buyer.

Link to section

status

string

Required

The current status of the refund (PENDING, APPROVED, REJECTED, or FAILED).

Link to section

processing_fee_money

The amount of Square processing fee money refunded to the merchant.

Link to section

additional_recipients

Deprecated

Additional recipients (other than the merchant) receiving a portion of this refund. For example, fees assessed on a refund of a purchase by a third party integration.