Glossary

Stripe Adjustable Quantity (adjustable_quantity)

Stripe adjustable quantity is a setting on a Checkout Session or Payment Link line item, adjustable_quantity, that lets the customer change how many units they buy on the payment page, within a minimum and maximum you set.

Also called: adjustable_quantity, Let customers adjust quantity, editable quantity at checkout

14-day free trial · card required · cancel anytime

Definition

Normally the quantity on a Checkout line item is fixed by your code or your Payment Link. Adjustable quantity hands that one number to the customer. The Price, the Product and the unit amount stay exactly as you set them, and the customer picks how many.

Stripe’s API reference describes the setting as configuration “for this item’s quantity to be adjusted by the customer during Checkout.” Its guide puts the purpose more plainly: set adjustable_quantity on your line_items “to enable your customers to update the quantity of an item during checkout.” In the Payment Links editor the same option is labeled “Let customers adjust quantity”.

The quantity you send when you create the session becomes the starting value, not the final one. The final quantity is whatever the customer confirms, which is why the amount charged is no longer something you know in advance.

Key points

  • +Set per line item as adjustable_quantity, with enabled (required) and optional minimum and maximum.
  • +Default minimum is 0 and default maximum is 99. Stripe accepts a maximum of up to 999999.
  • +If the line item’s starting quantity is above 99, the maximum must be at least that quantity.
  • +Available on Checkout Sessions and on Payment Links, in the API and the Payment Links editor.
  • +Stripe: Checkout “prevents the customer from removing an item if it’s the only item remaining.”
  • +Read the final quantities from the Checkout Session’s line items after payment, not from your request.
  • +The amount charged changes with the quantity, while the Product and Price IDs stay the same.

enabled, minimum and maximum

The adjustable_quantity object has three fields. enabled is required: Stripe’s reference says to set it “to true if the quantity can be adjusted to any non-negative integer.” minimum is “The minimum quantity the customer must purchase for the Checkout Session”, and Stripe notes that “By default this value is 0.” maximum is “The maximum quantity the customer can purchase for the Checkout Session”, which defaults to 99 and can go up to 999999.

The defaults are worth a second look. A minimum of 0 means the customer is not required to buy any of that item. If an item must stay in the order, set the minimum to 1. Stripe’s own example uses a minimum of 1 and a maximum of 10 on a 20 USD T-shirt.

There is one interaction to remember when you sell in bulk. Stripe’s guide says that when the starting quantity is greater than 99, the default maximum, you must “set adjustable_quantity.maximum to be greater than or equal to that item’s quantity.”

Checkout Sessions and Payment Links

On a Checkout Session you set adjustable_quantity inside each entry of line_items when you create the session. It works with a Price ID or an inline price. Each line item is configured on its own, so a cart can let the customer change the quantity of one item while another stays fixed.

On a Payment Link the same setting is available through the API, and in the Dashboard. Stripe’s Payment Links guide describes the Dashboard route: add a product, then in the Product section of the payment page “select Let customers adjust quantity in the product description. You can optionally set the minimum and maximum quantities.”

Because a Payment Link is reusable, the setting applies to every customer who opens it. One link can produce a one-unit sale in the morning and a ten-unit sale in the afternoon.

The quantity you send is only the starting point

When adjustable quantity is on, the line_items quantity in your request is the value the page opens with. The customer can change it before paying, so your request no longer tells you what was bought.

Stripe’s guide is direct about where to look instead: “After the payment completes, you can make a request for the finalized line items and their quantities.” It adds that if the customer removes a line item, “it’s also removed from the line items response.” Fulfillment, inventory and any reporting by units should read those finalized line items.

Inventory needs one more adjustment. Stripe advises that if you use adjustable quantities, you should reserve inventory using adjustable_quantity.maximum “instead of the line_items quantity”, since the customer can raise the quantity up to that maximum.

Why the amount stops identifying the product

With a fixed quantity, a 20 USD T-shirt link always produces a 20 USD sale. With adjustable quantity, the same link produces 20, 60 or 200 USD depending on what each customer chose. Add automatic tax or shipping and the totals spread further.

That breaks any bookkeeping habit that recognizes a product by its price: spotting a sale on a bank line by its amount, grouping revenue by amount in a report, or a matching rule keyed to a fixed value. What stays constant across every one of those sales is the Product and the Price, so those are the identifiers to build reporting and mapping around.

How adjustable-quantity sales reach QuickBooks with Acodei

On real-time accounts, Acodei books a successful Stripe charge as a QuickBooks sales receipt by default, with line items resolved through product mapping and unmapped lines sent to the default product. Accounts on the daily balance summary get one aggregated receipt per day instead of a record per charge.

The varying amount decides which mapping rule works. Acodei’s Transaction Value mapping compares the gross amount to a fixed value you enter, so a rule set at 20 USD matches a one-shirt order and misses the three-shirt order on the same link. Map these sales by Stripe Product ID instead. Without the pricing tier, every price on that Stripe product goes to the same QuickBooks product. With the pricing tier, Acodei stores both the Product ID and the Price ID. If a sale matches no rule, it uses the default product or raises a sync error, depending on your settings.

If a sale also produces a Stripe invoice and Invoice Sync is on, the quantity column depends on one more setting. By default Acodei writes a quantity of 1 per QuickBooks invoice line. Quantity Tracking pushes the Stripe quantity instead. It is off by default, requires enablement on Acodei’s side, and is not available with inclusive tax.

Want to see this on your own Stripe data?

Start a free trial

14-day free trial · card required · cancel anytime

Frequently asked questions

What is adjustable_quantity in Stripe?

It is a setting on a Checkout Session or Payment Link line item that lets the customer change the quantity on the payment page. It has a required enabled flag and optional minimum and maximum values. Without a minimum or maximum, Stripe uses 0 and 99.

What are the default minimum and maximum for an adjustable quantity?

Stripe defaults the minimum to 0 and the maximum to 99. You can raise the maximum to 999999. If the starting quantity on the line item is above 99, you must set the maximum to at least that quantity, and set the minimum to 1 if the item must stay in the order.

Can I let customers change quantities on a Stripe Payment Link?

Yes. In the Payment Links editor, add a product and select Let customers adjust quantity in the Product section, optionally with a minimum and maximum. Through the API, set adjustable_quantity on the Payment Link’s line item, the same way you would on a Checkout Session.

How do I find the quantity the customer actually bought?

Request the Checkout Session’s line items after the payment completes. Stripe returns the finalized line items and their quantities, and a line item the customer removed is not in the response. The quantity you sent when creating the session is only the starting value.

How should adjustable-quantity sales be mapped to QuickBooks products?

With Acodei, map them by Stripe Product ID rather than by transaction value. Transaction Value mapping compares the gross amount to a fixed number, so it can’t match totals that change with the quantity. Product ID mapping with the pricing tier can also send each Price to its own QuickBooks product.

What customers say about running Stripe through Acodei

Stripe Verified Partner BadgeIntuit QuickBooks
★★★★★
“If you're testing out all the different Stripe/QuickBooks integration apps right now, let me save you some time. This one is the best one by far.”
RyanOwner at Indie Music Academy
★★★★★
“Works well and is really helpful for massive transactions. The support is really fast and helpful. 100% recommended.”
AndresCo-founder and CEO at Kanguro Collections and Reinsurance

Related reading

More glossary terms

See the full glossary

Ready to try Acodei?

Connect Stripe to QuickBooks Online in minutes and let the fees, refunds, and payouts land where your accountant expects them.

14-day free trial · card required · cancel anytime