Subscription Discount Data Now Available via Customer Account API
Effective July 1, 2025 • Shopify Customer Account API version 2025-07
Shopify has enhanced the Customer Account API by adding a new discounts connection to subscription contracts. Now, subscription discount details are accessible directly within customer-facing APIs not just through the Admin API help.shopify.com+12shopify.dev+12community.shopify.dev+12
What Changed: Customer Account API Can Now Report Subscription Discounts
Merchants and developers building storefront subscriptions will appreciate this update. Here’s what’s new:
-
The Customer Account API now includes a
discountsconnection on subscription contracts. -
This delivers the same detailed discount data found in the Admin API, including discount types, amounts, percentage values, and line-item allocations shopify.dev
-
No change is required in your existing Admin API this update is purely additive on the storefront side.
Why This Matters
1. Better Subscription Transparency for Customers
With discount details visible in the customer account, subscribers can see exactly how promotions are applied to their billing improving trust and clarity.
2. Simplified Headless & DTC Integration
For headless, Hydrogen, or custom storefronts, this enhancement lets you build subscription dashboards without relying on separate Admin calls.
3. Streamlined App Development
Apps managing subscriptions can now display discount data seamlessly on the storefrontno custom middleware needed.
How to Take Advantage
-
Update to Customer Account API version 2025‑07 or later.
-
Query subscription contracts using the new
discountsconnection to expose:-
Discount amounts and percentages
-
Which lines in the contract the discounts apply to
-
Allocation details for each discounted item
-
-
Use this data to power subscription account UIs with clear billing breakdowns in customer dashboards.
0 comments