---
title: >-
  totalUnsettledSet calculation fixed for pending captures - Shopify developer
  changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: >-
    https://shopify.dev/changelog/totalunsettledset-calculation-fixed-for-pending-captures
  md: >-
    https://shopify.dev/changelog/totalunsettledset-calculation-fixed-for-pending-captures.md
metadata:
  effectiveApiVersion: ''
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Breaking API Change
    handle: breaking-api-change
  indicatesActionRequired: false
  createdAt: '2026-02-03T15:54:11-05:00'
  postedAt: '2026-04-24T13:00:00-04:00'
  updatedAt: '2026-04-13T10:39:07-04:00'
  effectiveAt: '2026-02-04T12:00:00-05:00'
---

April 24, 2026

Tags:

* Admin GraphQL API

# `totalUnsettledSet` calculation fixed for pending captures

The [`totalUnsettledSet` field](https://shopify.dev/docs/api/admin-graphql/latest/objects/OrderTransaction#field-OrderTransaction.fields.totalUnsettledSet) on the `OrderTransaction` object now correctly calculates the unsettled amount when a capture is in pending status. The affected field is `OrderTransaction.totalUnsettledSet`.

## What's changed

Previously, when a capture was pending, `totalUnsettledSet` was double-counting by incorrectly returning the authorization amount plus the pending capture amount. Now it correctly returns the actual unsettled amount.

For example, for a $100 authorization with a $50 pending capture:

* Before: Returned $150 (incorrect)
* After: Returns $100 (correct)

## What you need to do

Nothing. Your existing queries will continue to work and no changes to your code are required. The returned value will now be correct.

## What this affects

This bug only affects multi-capturable orders, which are orders where partial or multiple captures are supported.

According to our API breaking change policy, bug fixes that correct values to match documented behavior are applied immediately across all API versions.

## Why we changed it

This update fixes a bug where the calculation double-counted during pending capture states. The `totalUnsettledSet` field represents the available amount with currency to capture on the gateway, but the previous value didn't reflect this.

This bug was introduced when multi-capturable support was added, and became more visible after Shopify Payments migrated to a flow where captures transition through `PENDING` status before `SUCCESS`.
