<- Object

Object

TerminalRefund

Represents a payment refund processed by the Square Terminal.

Only supports Interac (Canadian debit network) payment refunds.

Link to section

Properties

Link to section

id

string

Read only A unique ID for this TerminalRefund.

Min Length
10
Max Length
255
Link to section

refund_id

string

Read only The reference to the payment refund created by completing this TerminalRefund.

Link to section

payment_id

string

Required

The unique ID of the payment being refunded.

Min Length
1
Link to section

order_id

string

Read only The reference to the Square order ID for the payment identified by the payment_id.

Link to section

amount_money

Required

The amount of money, inclusive of tax_money, that the TerminalRefund should return. This value is limited to the amount taken in the original payment minus any completed or pending refunds.

Link to section

reason

string

Required

A description of the reason for the refund.

Max Length
192
Link to section

device_id

string

Required

The unique ID of the device intended for this TerminalRefund. The Id can be retrieved from /v2/devices api.

Link to section

deadline_duration

string

The RFC 3339 duration, after which the refund is automatically canceled. A TerminalRefund that is PENDING is automatically CANCELED and has a cancellation reason of TIMED_OUT.

Default: 5 minutes from creation.

Maximum: 5 minutes

Example for 2 days, 12 hours, 30 minutes, and 15 seconds: P2DT12H30M15S

Link to section

status

string

Read only The status of the TerminalRefund. Options: PENDING, IN_PROGRESS, CANCEL_REQUESTED, CANCELED, or COMPLETED.

Link to section

cancel_reason

string

Read only Present if the status is CANCELED.

Link to section

created_at

string

Read only The time when the TerminalRefund was created, as an RFC 3339 timestamp.

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

Link to section

updated_at

string

Read only The time when the TerminalRefund was last updated, as an RFC 3339 timestamp.

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

Link to section

app_id

string

Read only The ID of the application that created the refund.

Link to section

location_id

string

Read only The location of the device where the TerminalRefund was directed.

Max Length
64