• Example searches: “transaction”, “CreateOrder”, “/v2/locations”, “inventory”, “delete customer”

Object Index

You are viewing an old version of the API
TerminalRefund

Properties

Name Description
id
string

Read only A unique ID for this TerminalRefund.

Min Length 10 Max Length 255
refund_id
string

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

payment_id
string

Required

The unique ID of the payment being refunded.

Min Length 1
order_id
string

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

amount_money
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.

reason
string

A description of the reason for the refund. Note: maximum 192 characters

Max Length 192
device_id
string

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

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

status
string

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

cancel_reason
string

Read only Present if the status is CANCELED.

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

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

app_id
string

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

location_id
string

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

Share Feedback

Thanks for visiting the Square API documentation. What's on your mind?