<- Object

Object

All versions ->

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.

Link to section

tip_money

The tip's amount of the tender.

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.

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.

Link to section

card_details

The details of the card tender.

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

Link to section

cash_details

The details of the cash tender.

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

Link to section

bank_account_details

The details of the bank account tender.

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

Link to section

buy_now_pay_later_details

The details of a Buy Now Pay Later tender.

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

Link to section

square_account_details

The details of a Square Account tender.

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

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.

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.