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

Object Index

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.

The tenders field of this object lists all methods of payment used to pay in the transaction.

Properties

Name Description
id
string

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

Max Length 192
location_id
string

The ID of the transaction's associated location.

Max Length 50
created_at
string

The timestamp for 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

Max Length 32
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.

Max Length 40
product
string

The Square product that processed the transaction.

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.

Max Length 192
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.

Max Length 192

Share Feedback

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