Payouts GraphQL Missing Order from Tax Adjustments

GraphQL Admin API Troubleshooting
1

We are trying to update our payouts API calls to using GraphQL and can’t solve one final piece. On TAX_ADJUSTMENT_CREDIT, there is not a link back to the original order - but the admin shows the order. We need to be able to link this TAX_ADJUSTMENT_CREDIT back to the order that adjusted it.

query GetBalanceTransactionsForPayout($payoutId: String!) {
  shopifyPaymentsAccount {
    balanceTransactions(first: 100, query: $payoutId) {
      nodes {
        id
        transactionDate
        type
        net {
          amount
          currencyCode
        }
        fee { 
            amount
            currencyCode
        }
        sourceType
        sourceId
        sourceOrderTransactionId
        adjustmentReason
        associatedOrder {
          id
          name
        }
        adjustmentsOrders {
            amount {
                amount
                currencyCode
            }
            link
            name
            orderTransactionId
        }
        adjustmentReason
      }
      pageInfo {
        hasNextPage
        endCursor
      }
    }
  }
}

The Response for a TAX Adjustment

{
                        "id": "gid://shopify/ShopifyPaymentsBalanceTransaction/123456789",
                        "transactionDate": "2025-05-15T19:25:19Z",
                        "type": "TAX_ADJUSTMENT_CREDIT",
                        "net": {
                            "amount": "47.25",
                            "currencyCode": "USD"
                        },
                        "fee": {
                            "amount": "0.0",
                            "currencyCode": "USD"
                        },
                        "sourceType": "ADJUSTMENT",
                        "sourceId": "123456789",
                        "sourceOrderTransactionId": null,
                        "adjustmentReason": "tax_adjustment",
                        "associatedOrder": null,
                        "adjustmentsOrders": []
                    }

I have tried every different way to grab the associatedOrder, but never get a response on these adjustments. I do get the orders on everything else.

Anyone have any ideas?

2

Hey! This looks similar to this issue we are tracking here: GraphQL balanceTransactions: associatedOrder is Null for SHOPIFY_COLLECTIVE_CREDIT Type Despite UI Showing Order Link

I’ll dig in further to see what I can find.

4

Hey @Justin_Porter ,

The issue you are seeing is similar to the other one reported. I’ve let our team know about the missing link back to the Original order. If you can, follow the other thread and we will update that once there is a resolution.