---
title: TenderTransaction
description: Retrieve tender transactions for your shop. Tender transactions represent transactions that modify the shop's balance.
api_version: 2025-10
api_name: admin-rest
api_type: rest
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
---

![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)

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#get-tender-transactions)

  [/admin/api/latest/tender\_​transactions.​json](https://shopify.dev/docs/api/admin-rest/latest/resources/tendertransaction#get-tender-transactions)

  Retrieves a list of tender transactions

  [![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)](https://shopify.dev/docs/api/admin-graphql/latest/queries/tenderTransactions?example=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

->

[![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)](https://shopify.dev/docs/api/admin-graphql/latest/objects/TenderTransaction#field-TenderTransaction.fields.id)

[id](https://shopify.dev/docs/api/admin-graphql/latest/objects/TenderTransaction#field-TenderTransaction.fields.id)

The ID of the transaction.

***

order\_id

read-only

->

[![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)](https://shopify.dev/docs/api/admin-graphql/latest/objects/TenderTransaction#field-TenderTransaction.fields.order)

[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

->

[![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)](https://shopify.dev/docs/api/admin-graphql/latest/objects/TenderTransaction#field-TenderTransaction.fields.amount)

[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

->

[![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)](https://shopify.dev/docs/api/admin-graphql/latest/objects/TenderTransaction#field-TenderTransaction.fields.amount)

[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

->

[![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)](https://shopify.dev/docs/api/admin-graphql/latest/objects/TenderTransaction#field-TenderTransaction.fields.user)

[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

->

[![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)](https://shopify.dev/docs/api/admin-graphql/latest/objects/TenderTransaction#field-TenderTransaction.fields.test)

[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

->

[![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)](https://shopify.dev/docs/api/admin-graphql/latest/objects/TenderTransaction#field-TenderTransaction.fields.processedAt)

[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

->

[![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)](https://shopify.dev/docs/api/admin-graphql/latest/objects/TenderTransaction#field-TenderTransaction.fields.remoteReference)

[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

->

[![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)](https://shopify.dev/docs/api/admin-graphql/latest/objects/TenderTransaction#field-TenderTransaction.fields.transactionDetails)

[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:

Show payment\_details 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

->

[![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)](https://shopify.dev/docs/api/admin-graphql/latest/objects/TenderTransaction#field-TenderTransaction.fields.paymentMethod)

[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:

Show payment\_method properties

* **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

[![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)](https://shopify.dev/docs/api/admin-graphql/latest/queries/tenderTransactions?example=retrieves-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=​1011222832

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/2025-10/tender\_​transactions.​json

```bash
curl -X GET "https://your-development-store.myshopify.com/admin/api/2025-10/tender_transactions.json" \
-H "X-Shopify-Access-Token: {access_token}"
```

{}

## Response

JSON

```json
HTTP/1.1 200 OK
{
  "tender_transactions": [
    {
      "id": 1011222831,
      "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": 1011222830,
      "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/2025-10/tender_transactions.json" \
  -H "X-Shopify-Access-Token: {access_token}"
  ```

  #####

  ```remix
  await admin.rest.resources.TenderTransaction.all({
    session: session,
  });
  ```

  #####

  ```ruby
  # Session is activated via Authentication
  test_session = ShopifyAPI::Context.active_session

  ShopifyAPI::TenderTransaction.all(
    session: test_session,
  )
  ```

  #####

  ```node
  // Session is built by the OAuth process

  await shopify.rest.TenderTransaction.all({
    session: session,
  });
  ```

  #### response

  ```json
  HTTP/1.1 200 OK{"tender_transactions":[{"id":1011222831,"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":1011222830,"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/2025-10/tender_transactions.json?since_id=1011222832" \
  -H "X-Shopify-Access-Token: {access_token}"
  ```

  #####

  ```remix
  await admin.rest.resources.TenderTransaction.all({
    session: session,
    since_id: "1011222832",
  });
  ```

  #####

  ```ruby
  # Session is activated via Authentication
  test_session = ShopifyAPI::Context.active_session

  ShopifyAPI::TenderTransaction.all(
    session: test_session,
    since_id: "1011222832",
  )
  ```

  #####

  ```node
  // Session is built by the OAuth process

  await shopify.rest.TenderTransaction.all({
    session: session,
    since_id: "1011222832",
  });
  ```

  #### 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"}]}
  ```

* #### Retrieve tender transactions ordered by \<code>processed\_at\</code>

  #####

  ```curl
  curl -X GET "https://your-development-store.myshopify.com/admin/api/2025-10/tender_transactions.json?order=processed_at+ASC" \
  -H "X-Shopify-Access-Token: {access_token}"
  ```

  #####

  ```remix
  await admin.rest.resources.TenderTransaction.all({
    session: session,
    order: "processed_at ASC",
  });
  ```

  #####

  ```ruby
  # Session is activated via Authentication
  test_session = ShopifyAPI::Context.active_session

  ShopifyAPI::TenderTransaction.all(
    session: test_session,
    order: "processed_at ASC",
  )
  ```

  #####

  ```node
  // Session is built by the OAuth process

  await shopify.rest.TenderTransaction.all({
    session: session,
    order: "processed_at ASC",
  });
  ```

  #### response

  ```json
  HTTP/1.1 200 OK{"tender_transactions":[{"id":1011222834,"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"},{"id":1011222835,"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"}]}
  ```

* #### Retrieve tender transactions processed\_at or after the specified date

  #####

  ```curl
  curl -X GET "https://your-development-store.myshopify.com/admin/api/2025-10/tender_transactions.json?processed_at_min=2005-08-06+10%3A22%3A51+-0400" \
  -H "X-Shopify-Access-Token: {access_token}"
  ```

  #####

  ```remix
  await admin.rest.resources.TenderTransaction.all({
    session: session,
    processed_at_min: "2005-08-06 10:22:51 -0400",
  });
  ```

  #####

  ```ruby
  # Session is activated via Authentication
  test_session = ShopifyAPI::Context.active_session

  ShopifyAPI::TenderTransaction.all(
    session: test_session,
    processed_at_min: "2005-08-06 10:22:51 -0400",
  )
  ```

  #####

  ```node
  // Session is built by the OAuth process

  await shopify.rest.TenderTransaction.all({
    session: session,
    processed_at_min: "2005-08-06 10:22:51 -0400",
  });
  ```

  #### response

  ```json
  HTTP/1.1 200 OK{"tender_transactions":[{"id":1011222837,"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"}]}
  ```

* #### Retrieve tender transactions processed\_at or before the specified date

  #####

  ```curl
  curl -X GET "https://your-development-store.myshopify.com/admin/api/2025-10/tender_transactions.json?processed_at_max=2005-08-06+10%3A22%3A51+-0400" \
  -H "X-Shopify-Access-Token: {access_token}"
  ```

  #####

  ```remix
  await admin.rest.resources.TenderTransaction.all({
    session: session,
    processed_at_max: "2005-08-06 10:22:51 -0400",
  });
  ```

  #####

  ```ruby
  # Session is activated via Authentication
  test_session = ShopifyAPI::Context.active_session

  ShopifyAPI::TenderTransaction.all(
    session: test_session,
    processed_at_max: "2005-08-06 10:22:51 -0400",
  )
  ```

  #####

  ```node
  // Session is built by the OAuth process

  await shopify.rest.TenderTransaction.all({
    session: session,
    processed_at_max: "2005-08-06 10:22:51 -0400",
  });
  ```

  #### response

  ```json
  HTTP/1.1 200 OK{"tender_transactions":[{"id":1011222826,"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 processed\_at the specified date

  #####

  ```curl
  curl -X GET "https://your-development-store.myshopify.com/admin/api/2025-10/tender_transactions.json?processed_at_max=2005-08-05+10%3A22%3A51+-0400" \
  -H "X-Shopify-Access-Token: {access_token}"
  ```

  #####

  ```remix
  await admin.rest.resources.TenderTransaction.all({
    session: session,
    processed_at_max: "2005-08-05 10:22:51 -0400",
  });
  ```

  #####

  ```ruby
  # Session is activated via Authentication
  test_session = ShopifyAPI::Context.active_session

  ShopifyAPI::TenderTransaction.all(
    session: test_session,
    processed_at_max: "2005-08-05 10:22:51 -0400",
  )
  ```

  #####

  ```node
  // Session is built by the OAuth process

  await shopify.rest.TenderTransaction.all({
    session: session,
    processed_at_max: "2005-08-05 10:22:51 -0400",
  });
  ```

  #### response

  ```json
  HTTP/1.1 200 OK{"tender_transactions":[{"id":1011222828,"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"}]}
  ```