Feature request: Persisted inventoryBehaviour: BYPASS for draft orders and invoice checkout

Feature request: Persisted inventoryBehaviour: BYPASS for draft orders and invoice checkout

We have a workflow in which inventory for certain merchandise has already been handled in a previous transaction or external process. A subsequent draft order is created to collect an additional customer payment through Shopify’s hosted invoice checkout.

The draft order must use real variantId values because Shopify’s shipping calculations can depend on product identity, including:

  • Shipping profiles

  • Markets and market-specific shipping rules

  • Product collections

  • Carrier services

  • Variant attributes

  • Other delivery customizations

Custom draft-order line items are not sufficient because they do not retain this product and variant context. As a result, Shopify may calculate different or incomplete shipping options.

Using real variants solves the shipping-calculation problem, but completing the draft order can cause Shopify to process inventory for those variants again, even though inventory was already accounted for elsewhere.

The orderCreate mutation supports inventoryBehaviour, including BYPASS. Draft orders currently have no equivalent persisted option.

Requested API

Please add an inventoryBehaviour field to draft orders, ideally using the same enum and behavior as orderCreate.

For example:

mutation DraftOrderCreate($input: DraftOrderInput!) {
  draftOrderCreate(
    input: {
      lineItems: [
        {
          variantId: "gid://shopify/ProductVariant/123"
          quantity: 1
          priceOverride: {
            amount: "0.00"
            currencyCode: USD
          }
        }
      ]
      inventoryBehaviour: BYPASS
    }
  ) {
    draftOrder {
      id
      inventoryBehaviour
      invoiceUrl
    }
    userErrors {
      field
      message
    }
  }
}

The selected behavior should be stored on the draft order and respected regardless of how it becomes an order:

  • Customer completion through the hosted invoice checkout

  • Completion through draftOrderComplete

  • Completion by a merchant in Shopify Admin

With BYPASS, the resulting order should not reserve, commit, decrement, restock, or otherwise adjust inventory for its variant-backed line items.

Adding this option only to draftOrderComplete would not cover hosted payment flows, because customers can complete and pay for draft orders directly through Shopify’s invoice checkout without the app calling draftOrderComplete.

Why existing options do not solve this

reserveInventoryUntil addresses the opposite requirement by reserving inventory for a future purchase. In this scenario, inventory has already been processed.

Creating an order directly with orderCreate and inventoryBehaviour: BYPASS is also insufficient because the customer still needs to complete payment through Shopify’s hosted checkout.

Custom line items avoid inventory changes, but remove the product identity required for Shopify’s normal shipping calculations.

Potential use cases

This capability could support:

  • Additional payment flows related to existing purchases

  • Replacement and reshipment charges

  • Preorder and multi-stage order workflows

  • Orders whose inventory was handled by another transaction

  • Migration and reconciliation workflows requiring Shopify-hosted payment

  • Shipping-only or service-charge checkouts that still require variant-aware delivery rates

Fulfillment-order consideration

Some workflows may also require variant-backed lines for checkout and reporting context without creating new operational fulfillment work.

An additional option such as fulfillmentBehaviour: SKIP, or another supported mechanism for making these lines non-actionable after checkout, would help prevent duplicate fulfillment work for merchants and connected fulfillment systems.

Inventory bypass is the immediate missing capability, while fulfillment-order behavior is a related concern.

Expected outcome

The customer should be able to:

  1. Open a Shopify-hosted invoice checkout.

  2. Receive shipping rates calculated using real product variants.

  3. Complete the required payment.

  4. Create an order that retains variant references for reporting and shipping context.

  5. Avoid any additional inventory reservation, commitment, decrement, or restock.

  6. Optionally avoid creating fulfillment work for merchandise already handled elsewhere.

Would Shopify consider adding a persisted inventoryBehaviour option to draft orders that is honored when the customer completes payment through the hosted invoice checkout?

Bumping this as i have not had a response yet

Hey @Jeroen_Boers - thanks for raising this, and sorry this was missed and you had to bump the thread.

I reviewed the request, and your read is correct. There isn’t currently a persisted inventoryBehaviour option for draft orders that can be honoured across hosted invoice checkout, draftOrderComplete, and completion in Shopify Admin.

I’ve submitted this as a feature request and will follow up here if anything changes. Thanks again for taking the time to document the use case in detail, that’s very helpful so that we can understand the impact of the request.

Hey @Jeroen_Boers - just checking back in. Although draft orders still don’t support a persisted inventoryBehaviour, I may have a workaround you can use.

If the reason you’re using a draft order is to let the customer pay through Shopify’s hosted checkout, orderCreate may still fit your use case. The order can be created with a pending payment status while bypassing inventory, then an order invoice can be sent to the customer.

mutation orderCreateUnpaidBypassInventory {
  orderCreate(
    order: {
      lineItems: [
        {
          variantId: "gid://shopify/ProductVariant/1234567"
          quantity: 20
        }
      ]
      financialStatus: PENDING
    }
    options: {
      inventoryBehaviour: BYPASS
    }
  ) {
    order {
      id
      name
      paymentCollectionDetails {
        additionalPaymentCollectionUrl
      }
      lineItems(first: 10) {
        edges {
          node {
            title
            quantity
            fulfillableQuantity
          }
        }
      }
    }
    userErrors {
      field
      message
    }
  }
}

After creating the order, you can use orderInvoiceSend to email the customer the hosted checkout link.

Docs:

If for any reason this isn’t a fit for you, we want to hear why! Please let us know, as we are always open to feedback.

Hope this helps!

Hi @Wes-Dev-Shopify, thanks for following up and suggesting this. I tried the orderCreate approach, but ran into another blocker.

The resulting hosted payment page does not let the customer choose from the merchant’s normal shipping methods. I can supply a shipping charge upfront, but I need Shopify to calculate the available rates from the real variants and delivery profiles, then let the customer select their preferred method before paying.

Is that supported for an unpaid order created through orderCreate, or does the invoice page only collect the balance already established on the order?

The Help Center article you linked says customers can select a shipping method when paying a pending-order invoice, which makes the behaviour confusing.

If there is a supported configuration, could you share an example that lets the customer choose a delivery-profile rate on the hosted payment page while retaining inventoryBehaviour: BYPASS?

If shipping must always be selected and priced before creating the order, the original feature request is still needed for our use case: real variant references, customer-selected shipping in Shopify checkout, and no second inventory adjustment.

There is a possible work-around, where could retrieve Shopify-calculated rates using draftOrderCalculate, and let a customer select a shipping rate before checkout, but that seems like it is against ToS

Thanks again for looking into this!

Hey @Jeroen_Boers - thanks for testing this and clarifying the remaining requirement. You’re right that the orderCreate approach isn’t an exact workaround. It covers variant context, inventory bypass, and hosted payment collection, but the invoice flow you tested doesn’t give the customer the normal delivery-profile rate selection before payment.

One possible variation as you mentioned would be to use draftOrderCalculate after collecting the shipping address, present the returned rates in your storefront, then copy the customer’s selected rate and price into orderCreate before sending the invoice. Payment would still be collected through the Shopify checkout. However, orderCreate can’t accept the calculated shippingRateHandle, and I haven’t found documentation confirming or prohibiting this specific end-to-end pattern, so I can’t present it as a supported workaround without further confirmation.

The Help Center article says customers can select a shipping method when paying an invoice for an order with deferred payment terms, but it doesn’t clarify whether that applies to an API-created pending order using this flow. The article doesn’t specifically mention draft orders, however the specific part about selecting a shipping method does appear to be implying that the sent invoice originated from a draft order. I’m going to dig into this further.

If the requirement is for the customer to choose a Shopify-calculated rate within Shopify’s hosted invoice checkout, the original feature gap remains. I’ve added this additional context to the existing feature request.

Thanks again for trying the suggested approach and documenting where it falls short.

Awesome, thanks for taking the time to look into this further Wes, and for passing the extra info on

The draftOrderCalculate approach is definitely a stop-gap solution but I’d hate to be doing things that can get our app unlisted. Would be great to have confirmation on that one if that is the way it should be done. Any idea who we can loop in on this conversation to get that question resolved?

Hi @Jeroen_Boers - thanks for your patience here.

Just a quick update that I’m still looking into the viability of the workaround you proposed and I’ll follow up with you in this thread as soon as I have more info.

Hey @Wes-Dev-Shopify, thanks again for keeping me updated and for continuing to look into this!

If possible, I’d still strongly prefer the originally suggested inventoryBehaviour: BYPASS support for draft orders. That would let us keep the entire flow within Shopify’s standard checkout experience, rather than having to build and maintain our own shipping-rate selection flow around draftOrderCalculate.

The workaround could certainly get us there if it’s confirmed to be supported, but having the bypass behaviour persisted on the draft order would be a much cleaner solution for our use case and would let Shopify continue handling the parts it already does best.

Hey @Jeroen_Boers - just a quick update to let you know I haven’t forgotten about this. I’m still seeking confirmation on the proposed workaround and will follow up here when I have more confirmed guidance to share. Thanks for your patience!

Hey @Jeroen_Boers - thanks for your patience while I look into the proposed draftOrderCalculate workaround.

After doing some digging, we can’t provide pre-rulings or interpret the API Terms of Service, but the flow as described wouldn’t be approvable under App Store requirement 1.1.2, Use Shopify checkout. Collecting payment on Shopify’s hosted page doesn’t meet this requirement on its own. In this flow, your app would collect the buyer’s shipping address and shipping rate in its storefront, then push them into an order with orderCreate. Our App Store requirement treats this as order insertion because that information needs to be collected through Shopify checkout itself, which echoes your concern.

Thanks for your patience and for calling out this gap. As mentioned, I’ve brought your feedback to our team and documented it formally as a feature request.

Hey @Wes-Dev-Shopify, still awaiting a solution for this. Our customers are asking for it frequently