Object Index / Definition

You are viewing an old version of the API
Transaction

Deprecated

Represents a transaction processed with Square, either with the Connect API or with Square Point of Sale.

Properties

Name Description
id
string

The transaction's unique ID, issued by Square payments servers.

location_id
string

The ID of the transaction's associated location.

created_at
string

The time when the transaction was created, in RFC 3339 format.

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

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

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

tenders
Tender [ ]

The tenders used to pay in the transaction.

refunds
Refund [ ]

Refunds that have been applied to any tender in the transaction.

reference_id
string

If the transaction was created with the Charge endpoint, this value is the same as the value provided for the reference_id parameter in the request to that endpoint. Otherwise, it is not set.

product
string

The Square product that processed the transaction. See TransactionProduct for possible values

client_id
string

If the transaction was created in the Square Point of Sale app, this value is the ID generated for the transaction by Square Point of Sale.

This ID has no relationship to the transaction's canonical id, which is generated by Square's backend servers. This value is generated for bookkeeping purposes, in case the transaction cannot immediately be completed (for example, if the transaction is processed in offline mode).

It is not currently possible with the Connect API to perform a transaction lookup by this value.

shipping_address
Address

The shipping address provided in the request, if any.

order_id
string

The order_id is an identifier for the order associated with this transaction, if any.

Share Feedback

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