--- title: TenderTransaction description: >- Retrieve tender transactions for your shop. Tender transactions represent transactions that modify the shop's balance. api_version: 2026-07 source_url: html: 'https://shopify.dev/docs/api/admin-rest/latest/resources/tendertransaction' md: >- https://shopify.dev/docs/api/admin-rest/latest/resources/tendertransaction.md api_name: admin-rest api_type: rest --- The REST Admin API is a legacy API as of October 1, 2024. Starting April 1, 2025, all new public apps must be built exclusively with the [GraphQL Admin API](https://shopify.dev/docs/api/admin-graphql). For details and migration steps, visit our [migration guide](https://shopify.dev/docs/apps/build/graphql/migrate). # Tender​Transaction **Requires \`orders\` access scope.:** 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. \# ## Endpoints * [get](https://shopify.dev/docs/api/admin-rest/latest/resources/tendertransaction.md#get-tender-transactions) [/admin/api/latest/tender\_​transactions.​json](https://shopify.dev/docs/api/admin-rest/latest/resources/tendertransaction.md#get-tender-transactions) Retrieves a list of tender transactions [tenderTransactions](https://shopify.dev/docs/api/admin-graphql/latest/queries/tenderTransactions?example=retrieves-a-list-of-tender-transactions) *** ## The TenderTransaction resource ### Properties *** id **read-only** ->[id](https://shopify.dev/docs/api/admin-graphql/latest/objects/TenderTransaction#field-TenderTransaction.fields.id) The ID of the transaction. *** order\_id **read-only** ->[order](https://shopify.dev/docs/api/admin-graphql/latest/objects/TenderTransaction#field-TenderTransaction.fields.order) The ID of the order that the tender transaction belongs to. *** amount **read-only** ->[amount](https://shopify.dev/docs/api/admin-graphql/latest/objects/TenderTransaction#field-TenderTransaction.fields.amount) The amount of the tender transaction in the shop's currency. *** currency **read-only** ->[amount](https://shopify.dev/docs/api/admin-graphql/latest/objects/TenderTransaction#field-TenderTransaction.fields.amount) The three-letter code ([ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) format) for the currency used for the tender transaction. *** user\_id **read-only** ->[user](https://shopify.dev/docs/api/admin-graphql/latest/objects/TenderTransaction#field-TenderTransaction.fields.user) The ID of the user logged into the Shopify POS device that processed the tender transaction, if applicable. *** test **read-only** ->[test](https://shopify.dev/docs/api/admin-graphql/latest/objects/TenderTransaction#field-TenderTransaction.fields.test) Whether the tender transaction is a test transaction. *** processed\_at **read-only** ->[processedAt](https://shopify.dev/docs/api/admin-graphql/latest/objects/TenderTransaction#field-TenderTransaction.fields.processedAt) The date and time ([ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format) when the tender transaction was processed. *** remote\_reference **read-only** ->[remoteReference](https://shopify.dev/docs/api/admin-graphql/latest/objects/TenderTransaction#field-TenderTransaction.fields.remoteReference) The remote (gateway) reference associated with the tender. *** payment\_details **read-only** ->[transactionDetails](https://shopify.dev/docs/api/admin-graphql/latest/objects/TenderTransaction#field-TenderTransaction.fields.transactionDetails) 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** ->[paymentMethod](https://shopify.dev/docs/api/admin-graphql/latest/objects/TenderTransaction#field-TenderTransaction.fields.paymentMethod) 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** *** {} ## The TenderTransaction resource ```json { "id": 999225661, "order_id": 450789469, "amount": "10.00", "currency": "USD", "user_id": 106045196, "test": true, "processed_at": "2012-03-13T16:09:54-04:00", "remote_reference": "ch_1AtJu6CktlpKSclI4zjeQb2t", "payment_details": { "credit_card_number": "•••• •••• •••• 4242", "credit_card_company": "Visa" }, "payment_method": "credit_card" } ``` *** ## getRetrieves a list of tender transactions [tenderTransactions](https://shopify.dev/docs/api/admin-graphql/latest/queries/tenderTransactions?example=retrieves-a-list-of-tender-transactions) Retrieves a list of tender transactions. **Note:** This endpoint implements pagination by using links that are provided in the response header. To learn more, refer to [Make paginated requests to the REST Admin API](https://shopify.dev/api/usage/pagination-rest). ### Parameters *** api\_version **string** **required** *** limit **≤ 250** **default 50** The maximum number of results to retrieve. *** order Show tender transactions ordered by processed\_at in ascending or descending order. *** processed\_at Show tender transactions processed at the specified date. *** processed\_at\_max Show tender transactions processed\_at or before the specified date. *** processed\_at\_min Show tender transactions processed\_at or after the specified date. *** since\_id Retrieve only transactions after the specified ID. *** ### Examples ### Retrieve all tender transactions ### Retrieve tender transactions after the specified ID ### Query parameters since\_​id=​1011222838 Retrieve only transactions after the specified ID. ### Retrieve tender transactions ordered by `processed_at` ### Query parameters order=​processed\_at+ASC Show tender transactions ordered by processed\_at in ascending or descending order. ### Retrieve tender transactions processed\_at or after the specified date ### Query parameters processed\_​at\_​min=​2005-08-06+10:22:51+-0400 Show tender transactions processed\_at or after the specified date. ### Retrieve tender transactions processed\_at or before the specified date ### Query parameters processed\_​at\_​max=​2005-08-06+10:22:51+-0400 Show tender transactions processed\_at or before the specified date. ### Retrieve tender transactions processed\_at the specified date ### Query parameters processed\_​at\_​max=​2005-08-05+10:22:51+-0400 Show tender transactions processed\_at or before the specified date. get ## /admin/api/2026-07/tender\_​transactions.​json ```bash curl -X GET "https://your-development-store.myshopify.com/admin/api/2026-07/tender_transactions.json" \ -H "X-Shopify-Access-Token: {access_token}" ``` {} ## Response JSON ```json HTTP/1.1 200 OK { "tender_transactions": [ { "id": 1011222833, "order_id": 450789469, "amount": "250.94", "currency": "USD", "user_id": null, "test": false, "processed_at": "2005-08-07T10:22:51-04:00", "remote_reference": "authorization-key", "payment_details": null, "payment_method": "credit_card" }, { "id": 1011222832, "order_id": 450789469, "amount": "250.94", "currency": "USD", "user_id": null, "test": false, "processed_at": "2005-08-05T10:22:51-04:00", "remote_reference": "authorization-key", "payment_details": null, "payment_method": "credit_card" } ] } ``` ### examples * #### Retrieve all tender transactions ##### ```curl curl -X GET "https://your-development-store.myshopify.com/admin/api/2026-07/tender_transactions.json" \ -H "X-Shopify-Access-Token: {access_token}" ``` #### response ```json HTTP/1.1 200 OK{"tender_transactions":[{"id":1011222833,"order_id":450789469,"amount":"250.94","currency":"USD","user_id":null,"test":false,"processed_at":"2005-08-07T10:22:51-04:00","remote_reference":"authorization-key","payment_details":null,"payment_method":"credit_card"},{"id":1011222832,"order_id":450789469,"amount":"250.94","currency":"USD","user_id":null,"test":false,"processed_at":"2005-08-05T10:22:51-04:00","remote_reference":"authorization-key","payment_details":null,"payment_method":"credit_card"}]} ``` * #### Retrieve tender transactions after the specified ID ##### ```curl curl -X GET "https://your-development-store.myshopify.com/admin/api/2026-07/tender_transactions.json?since_id=1011222838" \ -H "X-Shopify-Access-Token: {access_token}" ``` * #### Retrieve tender transactions ordered by \processed\_at\ ##### ```curl curl -X GET "https://your-development-store.myshopify.com/admin/api/2026-07/tender_transactions.json?order=processed_at+ASC" \ -H "X-Shopify-Access-Token: {access_token}" ``` * #### Retrieve tender transactions processed\_at or after the specified date ##### ```curl curl -X GET "https://your-development-store.myshopify.com/admin/api/2026-07/tender_transactions.json?processed_at_min=2005-08-06+10%3A22%3A51+-0400" \ -H "X-Shopify-Access-Token: {access_token}" ``` * #### Retrieve tender transactions processed\_at or before the specified date ##### ```curl curl -X GET "https://your-development-store.myshopify.com/admin/api/2026-07/tender_transactions.json?processed_at_max=2005-08-06+10%3A22%3A51+-0400" \ -H "X-Shopify-Access-Token: {access_token}" ``` * #### Retrieve tender transactions processed\_at the specified date ##### ```curl curl -X GET "https://your-development-store.myshopify.com/admin/api/2026-07/tender_transactions.json?processed_at_max=2005-08-05+10%3A22%3A51+-0400" \ -H "X-Shopify-Access-Token: {access_token}" ```