Draft order deposit fields are now available in the GraphQL Admin API and Customer Account API

Shopify Adds Deposit Fields to Draft Order APIs

Shopify has added deposit functionality to draft orders in the GraphQL Admin API and Customer Account API as of the 2026-07 API version.

What Changed

Developers can now set deposit amounts when creating or updating draft orders using the DraftOrderInput.deposit field in the GraphQL Admin API. The Customer Account API provides read-only access to deposit information on draft orders, allowing customers to view deposit details through their account interface.

This update enables split payment workflows where customers pay a portion upfront at checkout and settle the remaining balance at a later time. The most common use case is due-on-fulfillment payment terms, where the deposit secures the order and the final payment processes when items ship.

Developer Impact

Apps that handle draft orders can now build deposit-based payment flows without custom workarounds. This applies to apps managing pre-orders, custom orders, or B2B transactions where partial upfront payment is standard practice.

The API change affects how draft order data structures work. Developers building or maintaining apps that create draft orders will need to account for the new deposit field in their API calls when targeting the 2026-07 version or later.

Implementation Considerations

Apps using earlier API versions will continue to function without changes. Developers who want to implement deposit functionality must update to the 2026-07 API version. The Customer Account API’s read-only deposit fields mean customers can view deposit information but cannot modify it through their account interface.

Read the full announcement →