Discover the Latest Features and Enhancements in Shopify's Most Recent API Update

The Shopify API update brings a wide array of new features and improvements, with a strong emphasis on enhancing the platform's performance and strengthening its security. This major update is designed to empower both developers and merchants by providing advanced tools and capabilities to elevate their e-commerce operations. In this blog post, we’ll take a closer look at the key changes and guide you through the next steps to make the most of these updates. Overview of the Update To stay ahead in the ever-evolving world of e-commerce, Shopify continues to innovate. This ongoing commitment to improvement is reflected in the latest API update, which introduces a range of new and enhanced features. From more robust APIs to upgraded security measures, this update ensures that Shopify remains at the forefront of digital commerce solutions on the web. Key Features and Enhancements 1. Admin API One of the key highlights of this update is the expanded functionality of the Admin API, particularly in managing orders, promotions, exchanges, and returns. These improvements are designed to enhance the overall customer experience and streamline e-commerce operations. Applying Discounts to Draft Orders Draft Orders and Discounts: Add discountCodes field to apply discount codes to draft orders. Use acceptAutomaticDiscounts to control whether automatic discounts apply. View platform discount details with the platformDiscounts field. Exchanges and Returns: Add exchangeLineItems to the returnCreate mutation for handling exchanges. Include discounts and fees with the ExchangeLineItemAppliedDiscountInput. Remove items from a return using the returnLineItemRemoveFromReturn mutation. Preview return financials using the returnCalculate query. Fulfillment Handling: Identify PICKUP_POINT deliveries via the DeliveryMethodType enum. Access fulfillment orders through the new QueryRoot.assignedFulfillmentOrders query. Product Data Enhancements: The PRODUCTS_CREATE/UPDATE webhooks now include product media. Link files, such as videos, with the fileUpdate mutation’s referencesToAdd field. Query and set metafields on selling plans with the metafields field. Checkout UI Customization: Configure the visibility of dividers in the checkout using the divided field on CheckoutBrandingInput. Market/Location Management: Promote a non-primary market to primary using the promoteMarketToPrimary mutation. Retrieve the retail location of an order using the Order.retailLocation field. Mobile App Integration: A new MobilePlatformApplication type is available for app credentials and links. Payment Processing: Query Shopify Payments balance transactions, fees, and order details. Capture authorizations multiple times with the finalCapture field (available for Shopify Plus). 2. Storefront API Enhancements The Storefront API, which powers the customer-facing storefront experiences, received a couple of key enhancements in this release focused on cart functionality. Managing Gift Cards on Carts Prior to this update, there was no built-in way to apply gift cards to a customer’s cart in the Storefront API. This limitation has now been addressed with the addition of two new functionalities: Adding Gift Card Codes When Creating a Cart: When creating a new cart, you can now optionally provide a list of gift card codes using the giftCardCodes field on the CartInput object. This allows immediately associating one or more gift cards when the cart is first created. Updating Gift Card Codes on an Existing Cart: For carts that have already been created, a new cartGiftCardCodesUpdate mutation has been added. This lets you add, remove, or replace the gift card codes applied to the cart after the fact. To check which gift cards have been successfully applied, you can use the new appliedGiftCards field on the Cart object to retrieve the list. Assigning a Billing Address to a Cart Another enhancement is the ability to associate a billing address with a cart using the new cartBillingAddressUpdate mutation. This allows setting the billing address for the order upfront, separate from the shipping address. Previously, the billing address could only be captured during checkout itself. But now, merchants can optionally accept this information earlier in the customer’s journey when adding items to their cart. These additions give merchants more flexibility in how gift cards and billing details are handled on the storefront, prior to initiating checkout. Shopify hopes these capabilities will enable the creation of smoother, more integrated shopping experiences for customers. 3. Shopify Function APIs The July 2024 release brings key enhancements to Shopify’s Function APIs, offering merchants more control over their payment methods and order fulfillment processes. These updates introduce greater flexibility, making it easier to customize the checkout experience and manage inventory routing efficiently. Payment Customization API Shopify Plus merchants can now take advantage of the enhanced Payment Customization API, which provides more control over which accelerated checkout payment methods appear in various parts of the checkout process. With the new hide operation, merchants can choose to hide specific payment methods from the following placements: The accelerated checkout buttons/options The main payment selection page Both placements at once This increased control allows Plus merchants to curate the checkout experience more precisely. For instance, they could opt to hide certain payment options from the accelerated checkout buttons but still make them available on the main payment page. This flexibility helps merchants tailor the experience for their customers and optimize their checkout flow. Order Routing Location Rule API For merchants using distributed inventory locations, the Order Routing Location Rule API has been updated to provide even more insightful recommendations about how to fulfill orders from multiple locations. A new lines field has been added to the FulfillmentGroup object returned by this API. This field contains detailed information about the specific cart line items included in each recommended fulfillment group/location. With access to these cart line item details, merchants can build richer integrations and perform deeper analyses to optimize their order fulfillment strategy. These improvements in the Function API provide Shopify merchants with increased transparency and control over the payment methods displayed during checkout, as well as better management of order routing across multiple locations. These updates are designed to streamline the checkout process, enhance the customer experience, and simplify order fulfillment logistics. 4. Product Enhancements This release includes several improvements related to product data and media capabilities: Product Webhooks Include Media Data The PRODUCTS_CREATE and PRODUCTS_UPDATE webhooks have been enhanced to include media files linked to products, whereas previously, they only contained basic product details. Now, when a product is created or updated, the webhook payload will include information about any associated images, videos, 3D models, or other media files that have been uploaded to the product. This update ensures that apps and integrations subscribed to these webhooks can easily stay up-to-date with the latest media changes for products in a merchant's Shopify store. Connect Media Files to Products Merchants and apps can now directly associate media files, such as 3D models and external videos, with products using the new referencesToAdd field on the fileUpdate mutation. This enhancement enables the creation of product pages with immersive 3D model visualizations or video overviews directly linked to products. Product Feed Variant Image Improvements For product feeds sent via the PRODUCT_FEEDS_INCREMENTAL_SYNC and PRODUCT_FEEDS_FULL_SYNC webhooks, the variant image data has been improved. Previously, if a variant didn’t have a specific image, the feed would default to the first image of the parent product. Now, the variant image field will only return an image if it has been specifically assigned to the variant, ensuring more accurate representation in product feeds. 5. Security and Compliance Updates A major security enhancement in this release focuses on preventing overselling for merchants offering subscription products and services. Overselling can occur when charges are processed for subscription orders, but there isn’t enough inventory to fulfill them. To address this issue, the following changes have been implemented: Inventory Checking for Subscription Billing: When processing a recurring subscription billing attempt, Shopify will now verify if sufficient inventory is available to fulfill the subscribed items. If the inventory is too low, the billing attempt will fail and return a new INSUFFICIENT_INVENTORY error. This enhancement prevents merchants from accidentally charging and overselling items they can't fulfill, offering better protection for subscription-based orders. Proper Payment Setup Requirement A new MISSING_CUSTOMER_PAYMENT_METHOD error can occur if attempting to finalize a subscription draft order without associated payment details. This ensures that payment is properly set up before processing the subscription order. Previously, subscriptions could be processed and charged without these essential inventory and payment checks in place. However, Shopify is now preventing overselling scenarios by: Verifying inventory levels against subscription quantities to ensure enough stock is available. Requiring the customer’s payment information to be configured correctly before proceeding with the subscription order. These enhancements provide critical safeguards for subscription merchants, ensuring inventory tracking remains accurate and minimizing fulfillment issues that could negatively impact customer satisfaction with recurring orders. Deprecations in the Shopify API While the July 2024 Shopify API update brings exciting new features, developers should be aware of some deprecations and breaking changes that could impact existing integrations: InventoryAdjustQuantity Mutation (Admin API): This mutation has been deprecated and replaced with the InventoryBulkAdjustQuantityAtLocation mutation. The new mutation enables more efficient bulk inventory adjustments at specific locations. Image Connections on Product Variants (Storefront API): The images connection on ProductVariant objects now requires the use of the first argument to limit the number of images returned. This change helps optimize performance and reduces unnecessary data transfer. Deprecated Fields: Several fields have been deprecated across various resources. While these fields will still function in the July 2024 update, they will be removed in future versions. Developers should update their code to avoid using these deprecated fields. For a complete list, refer to the official Shopify API release notes. Practical Applications and Tips The July 2024 Shopify API update unlocks numerous possibilities to enhance your Shopify store and build more powerful integrations. Here are some key applications and tips: Streamlined Inventory Management: Bulk Inventory Updates: Use the new InventoryBulkAdjustQuantityAtLocation mutation to efficiently manage inventory levels across multiple locations, saving time and reducing errors. Real-time Inventory Tracking: Implement the InventoryItemUpdate mutation to display real-time stock levels on your storefront, improving transparency and customer satisfaction. Enhanced Shopping Experience 3D Product Visualization: Integrate 3D models into product pages to offer immersive views, helping customers make more informed purchasing decisions. Video-Enhanced Descriptions: Use external videos to highlight product features and benefits, increasing engagement and driving conversions. Gift Card Integration: Enable seamless gift card purchases and redemptions via the API, boosting both sales and customer loyalty. Efficient Payments Management Shopify Payments Insights: Take advantage of the new Shopify Payments balance transaction types to gain valuable insights into your store's financial performance, streamline reporting, and improve payment reconciliation. Shopify Functions for Automation: Explore the new Shopify Functions APIs to automate payment-related tasks, including custom payment gateways, dynamic pricing rules, and other payment optimizations. Improved Mobile App Experiences Streamlined Logins: Use the MobilePlatformApplication type to enable shared web credentials and app links, simplifying the login process and enhancing the user experience for mobile app users. Future Outlook The July 2024 Shopify API update lays the foundation for exciting future developments in the Shopify ecosystem. As Shopify continues to evolve, we can expect several key trends and innovations: Expanded API Capabilities: Shopify will likely continue to broaden its API offerings, giving developers more tools and flexibility to create innovative solutions. This could include deeper integrations with third-party platforms, more robust data analysis tools, and enhanced customization features for storefronts. Focus on Headless Commerce: With the growing trend of decoupling the frontend and backend of e-commerce systems, Shopify's ongoing API enhancements will likely cater to headless commerce, enabling developers to build highly customized and flexible storefronts using their preferred technologies. AI and Automation: As AI and automation play an increasing role in e-commerce, Shopify may incorporate machine learning features into its APIs. This could enable merchants to leverage AI for personalized shopping experiences, smarter product recommendations, and more efficient inventory management. Enhanced Developer Experience: Shopify remains committed to improving the developer experience by providing comprehensive documentation, robust tools, and active community support. Future updates will likely make it even easier for developers to build, test, and deploy Shopify apps and integrations. Continued Focus on Security: Given the evolving nature of cybersecurity threats, Shopify is expected to prioritize security in its APIs. This could involve stronger authentication methods, more stringent data privacy controls, and proactive threat detection mechanisms. By staying updated on Shopify's API changes and emerging trends, developers can position themselves to take full advantage of the platform's potential, creating innovative solutions that drive growth for merchants.