Skip to content

Update accelerated checkouts to Storefront API 2026-07 #785

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
markmur merged 4 commits into from
Sep 18, 2026
Merged

Update accelerated checkouts to Storefront API 2026-07 #785

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
5838b97
Update accelerated checkouts to Storefront API 2026-07
markmur Sep 16, 2026
0b6da87
Migrate accelerated checkout discounts to cart applications
markmur Sep 16, 2026
49fe61b
Revert "Migrate accelerated checkout discounts to cart applications"
markmur Sep 17, 2026
85b561e
Align Storefront API docs and demo fallback with 2026-07
markmur Sep 18, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions platforms/android/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -72,13 +72,13 @@ dependencies {

Checkout Kit presents a standard Shopify checkout URL. The common flow is:

1. Create or update a cart with the [Storefront GraphQL API](https://shopify.dev/docs/api/storefront), for example with [`cartCreate`](https://shopify.dev/docs/api/storefront/2026-04/mutations/cartCreate) and related cart mutations.
2. Read the cart's [`checkoutUrl`](https://shopify.dev/docs/api/storefront/2026-04/objects/Cart#field-cart-checkouturl).
1. Create or update a cart with the [Storefront GraphQL API](https://shopify.dev/docs/api/storefront), for example with [`cartCreate`](https://shopify.dev/docs/api/storefront/2026-07/mutations/cartCreate) and related cart mutations.
2. Read the cart's [`checkoutUrl`](https://shopify.dev/docs/api/storefront/2026-07/objects/Cart#field-cart-checkouturl).
3. Pass that URL, or a [cart permalink](https://help.shopify.com/en/manual/products/details/cart-permalink), to Checkout Kit.

You can use any GraphQL client. The sample app uses Apollo Kotlin and is a complete reference for a modern Storefront API cart flow.

For production use, see the [Storefront API GraphiQL Explorer](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/getting-started) for schema exploration and the [`cartCreate`](https://shopify.dev/docs/api/storefront/2026-04/mutations/cartCreate) mutation reference for the full input shape, including buyer identity, attributes, discount codes, delivery addresses, and delivery options.
For production use, see the [Storefront API GraphiQL Explorer](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/getting-started) for schema exploration and the [`cartCreate`](https://shopify.dev/docs/api/storefront/2026-07/mutations/cartCreate) mutation reference for the full input shape, including buyer identity, attributes, discount codes, delivery addresses, and delivery options.

## Present checkout

Expand Down
6 changes: 3 additions & 3 deletions platforms/swift/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -91,13 +91,13 @@ pod "ShopifyCheckoutKit/AcceleratedCheckouts", "4.0.0-alpha.6"

Checkout Kit presents a standard Shopify checkout URL. The common flow is:

1. Create or update a cart with the [Storefront GraphQL API](https://shopify.dev/docs/api/storefront), for example with [`cartCreate`](https://shopify.dev/docs/api/storefront/2026-04/mutations/cartCreate) and related cart mutations.
2. Read the cart's [`checkoutUrl`](https://shopify.dev/docs/api/storefront/2026-04/objects/Cart#field-cart-checkouturl).
1. Create or update a cart with the [Storefront GraphQL API](https://shopify.dev/docs/api/storefront), for example with [`cartCreate`](https://shopify.dev/docs/api/storefront/2026-07/mutations/cartCreate) and related cart mutations.
2. Read the cart's [`checkoutUrl`](https://shopify.dev/docs/api/storefront/2026-07/objects/Cart#field-cart-checkouturl).
3. Pass that URL, or a [cart permalink](https://help.shopify.com/en/manual/products/details/cart-permalink), to Checkout Kit.

You can use any GraphQL client. The sample app uses Apollo iOS and is a complete reference for a modern Storefront API integration.

For production use, see the [Storefront API GraphiQL Explorer](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/getting-started) for schema exploration and the [`cartCreate`](https://shopify.dev/docs/api/storefront/2026-04/mutations/cartCreate) mutation reference for the full input shape, including buyer identity, attributes, discount codes, and delivery preferences.
For production use, see the [Storefront API GraphiQL Explorer](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/getting-started) for schema exploration and the [`cartCreate`](https://shopify.dev/docs/api/storefront/2026-07/mutations/cartCreate) mutation reference for the full input shape, including buyer identity, attributes, discount codes, and delivery preferences.

## Present checkout

Expand Down
2 changes: 1 addition & 1 deletion .../swift/Samples/CheckoutKitSwiftDemo/CheckoutKitSwiftDemo/Sources/Lib/InfoDictionary.swift
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@ final class InfoDictionary: Sendable {
fatalError("Missing required configuration. Check your info.plist.")
}

let apiVersion = infoPlist["API_VERSION"] as? String ?? "2026-04"
let apiVersion = infoPlist["API_VERSION"] as? String ?? "2026-07"

self.apiVersion = apiVersion
self.address1 = address1
Expand Down
2 changes: 1 addition & 1 deletion ...wift/Sources/ShopifyAcceleratedCheckouts/Internal/StorefrontAPI/StorefrontAPI+Types.swift
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -906,7 +906,7 @@ extension StorefrontAPI {
}

/// Represents shop settings data fetched from the Storefront API
/// https://shopify.dev/docs/api/storefront/2026-04/objects/Shop
/// https://shopify.dev/docs/api/storefront/2026-07/objects/Shop
@available(iOS 16.0, *)
class ShopSettings: ObservableObject {
/// The shop's name (merchant name for display)
Expand Down
2 changes: 1 addition & 1 deletion ...orms/swift/Sources/ShopifyAcceleratedCheckouts/Internal/StorefrontAPI/StorefrontAPI.swift
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ final class StorefrontAPI: ObservableObject, StorefrontAPIProtocol {
/// - Parameters:
/// - storefrontDomain: The shop domain (e.g., "example.myshopify.com")
/// - storefrontAccessToken: The storefront access token
/// - apiVersion: The API version to use (defaults to "2026-04")
/// - apiVersion: The API version to use (defaults to "2026-07")
/// - countryCode: Optional country code for localization
/// - languageCode: Optional language code for localization
init(
Expand Down
2 changes: 1 addition & 1 deletion platforms/swift/Sources/ShopifyAcceleratedCheckouts/ShopifyAcceleratedCheckouts.swift
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ import ShopifyCheckoutKit

public enum ShopifyAcceleratedCheckouts {
/// Storefront API version used for cart operations
internal static let apiVersion = "2026-04"
internal static let apiVersion = "2026-07"

internal static let name = "ShopifyAcceleratedCheckouts"

Expand Down
2 changes: 1 addition & 1 deletion ...forms/swift/Tests/ShopifyAcceleratedCheckoutsTests/ShopifyAcceleratedCheckoutsTests.swift
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,16 +10,16 @@

override func setUp() {
super.setUp()
originalLogLevel = ShopifyAcceleratedCheckouts.logLevel

Check warning on line 13 in platforms/swift/Tests/ShopifyAcceleratedCheckoutsTests/ShopifyAcceleratedCheckoutsTests.swift

View workflow job for this annotation

GitHub Actions / Swift / package-tests / Run Package Tests 

main actor-isolated property 'originalLogLevel' can not be mutated from a nonisolated context
}

override func tearDown() {
ShopifyAcceleratedCheckouts.logLevel = originalLogLevel

Check warning on line 17 in platforms/swift/Tests/ShopifyAcceleratedCheckoutsTests/ShopifyAcceleratedCheckoutsTests.swift

View workflow job for this annotation

GitHub Actions / Swift / package-tests / Run Package Tests 

main actor-isolated property 'originalLogLevel' can not be referenced from a nonisolated context
super.tearDown()
}

func test_apiVersion_whenAccessed_shouldBePublic() {
XCTAssertEqual(ShopifyAcceleratedCheckouts.apiVersion, "2026-04")
XCTAssertEqual(ShopifyAcceleratedCheckouts.apiVersion, "2026-07")
}

func test_logLevel_withDefaultConfiguration_shouldDefaultToWarn() {
Expand Down
6 changes: 3 additions & 3 deletions platforms/web/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -249,14 +249,14 @@ declare module 'react' {
To present checkout you first need a checkout URL. The most common way is to
use the [Storefront GraphQL API](https://shopify.dev/docs/api/storefront) to
assemble a cart (via `cartCreate` and related mutations) and read the
[`checkoutUrl`](https://shopify.dev/docs/api/storefront/2026-04/objects/Cart#field-cart-checkouturl)
[`checkoutUrl`](https://shopify.dev/docs/api/storefront/2026-07/objects/Cart#field-cart-checkouturl)
field. Alternatively, a
[cart permalink](https://help.shopify.com/en/manual/products/details/cart-permalink)
can be provided.

```ts
const response = await fetch(
'https://your-store.myshopify.com/api/2026-04/graphql.json',
'https://your-store.myshopify.com/api/2026-07/graphql.json',
{
method: 'POST',
headers: {
Expand Down Expand Up @@ -300,7 +300,7 @@ checkout.src = data.cartCreate.cart.checkoutUrl;
For production use, see the
[Storefront API GraphiQL Explorer](https://shopify.dev/docs/storefronts/headless/building-with-the-storefront-api/getting-started)
for schema exploration and the
[`cartCreate`](https://shopify.dev/docs/api/storefront/2026-04/mutations/cartCreate)
[`cartCreate`](https://shopify.dev/docs/api/storefront/2026-07/mutations/cartCreate)
mutation reference for the full input shape (buyer identity, attributes,
discount codes, delivery preferences, etc.).

Expand Down
Loading