<- Object

Object

Tender

Represents a tender (i.e., a method of payment) used in a Square transaction.

Link to section

Properties

Link to section

id

string

The tender's unique ID. It is the associated payment ID.

Link to section

location_id

string

The ID of the transaction's associated location.

Link to section

transaction_id

string

The ID of the tender's associated transaction.

Link to section

created_at

string

Read only The timestamp for when the tender 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

Link to section

note

string

An optional note associated with the tender at the time of payment.

Link to section

amount_money

The total amount of the tender, including tip_money. If the tender has a payment_id, the total_money of the corresponding Payment will be equal to the amount_money of the tender.

Show attributes
Link to section

tip_money

The tip's amount of the tender.

Show attributes
Link to section

processing_fee_money

The amount of any Square processing fees applied to the tender.

This field is not immediately populated when a new transaction is created. It is usually available after about ten seconds.

Show attributes
Link to section

customer_id

string

If the tender is associated with a customer or represents a customer's card on file, this is the ID of the associated customer.

Link to section

type

string

Required

The type of tender, such as CARD or CASH.

Show values
Link to section

card_details

The details of the card tender.

This value is present only if the value of type is CARD.

Show attributes
Link to section

cash_details

The details of the cash tender.

This value is present only if the value of type is CASH.

Show attributes
Link to section

additional_recipients

Deprecated

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

Show attributes
Link to section

payment_id

string

The ID of the Payment that corresponds to this tender. This value is only present for payments created with the v2 Payments API.