Access transactions on the Return object

You can now access transaction data directly from the Return object in the Admin GraphQL API. This new transactions connection simplifies your ability to associate payments and refunds with specific returns, removing the need to deduce relationships based on amounts and timestamps. This helps ensure accurate financial reporting and reconciliation for integrations.

The transactions connection is populated for the following scenarios:

• POS returns and exchanges: Includes both refunds and captured payments.
• Online returns and exchanges: Includes refunds only.

Here's an example of how to query transactions on a return:

query {
  return(id: "gid://shopify/Return/123") {
    transactions(first: 5) {
      edges {
        node {
          id
          kind
          status
          amountSet {
            shopMoney {
              amount
              currencyCode
            }
          }
        }
      }
    }
  }
}

For more details, refer to the Return object documentation.