TenderTransaction

TenderTransaction

Each tender transaction represents money passing between the merchant and a customer. A tender transaction with a positive amount represents a transaction where the customer paid money to the merchant. A negative amount represents a transaction where the merchant refunded money back to the customer. Tender transactions represent transactions that modify the shop’s balance.

What you can do with TenderTransaction

The Shopify API lets you do the following with the TenderTransaction resource. More detailed versions of these general actions may be available:

GET /admin/api/2021-01/tender_transactions.jsonRetrieves a list of tender transactions

TenderTransaction properties

id READ-ONLY	`plain "id": 999225661` The ID of the transaction.
order_id READ-ONLY	`plain "order_id": 450789469` The ID of the order that the tender transaction belongs to.
amount READ-ONLY	`plain "amount": "10.00"` The amount of the tender transaction in the shop’s currency.
currency READ-ONLY	`plain "currency": "USD"` The three-letter code (ISO 4217 format) for the currency used for the tender transaction.
user_id READ-ONLY	`plain "user_id": 106045196` The ID of the user logged into the Shopify POS device that processed the tender transaction, if applicable.
test READ-ONLY	`plain "test": true` Whether the tender transaction is a test transaction.
processed_at READ-ONLY	`plain "processed_at": "2012-03-13T16:09:54-04:00"` The date and time (ISO 8601 format) when the tender transaction was processed.
remote_reference READ-ONLY	`plain "remote_reference": "ch_1AtJu6CktlpKSclI4zjeQb2t"` The remote (gateway) reference associated with the tender.
payment_details READ-ONLY	`plain "payment_details": { "credit_card_number": "•••• •••• •••• 4242", "credit_card_company": "Visa" }` Information about the payment instrument used for this transaction. It has the following properties: + credit_card_company: The name of the company that issued the customer’s credit card. + credit_card_number: The customer’s credit card number, with most of the leading digits redacted.
payment_method READ-ONLY	`plain "payment_method": "credit_card"` Information about the payment method used for this transaction. Valid values: + credit_card + cash + android_pay + apple_pay + google_pay + samsung_pay + shopify_pay + amazon + klarna + paypal + unknown + other

Endpoints

GET/admin/api/2021-01/tender_transactions.json Retrieves a list of tender transactions. Note: As of version 2019-10, this endpoint implements pagination by using links that are provided in the response header. To learn more, see Making requests to paginated REST Admin API endpoints.

limit	The maximum number of results to retrieve. (default: `50` , maximum: `250` )
since_id	Retrieve only transactions after the specified ID.
processed_at_min	Show tender transactions processed_at or after the specified date.
processed_at_max	Show tender transactions processed_at or before the specified date.
processed_at	Show tender transactions processed at the specified date.
order	Show tender transactions ordered by processed_at in ascending or descending order.