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 trial14-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

“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.”
“Works well and is really helpful for massive transactions. The support is really fast and helpful. 100% recommended.”
Related reading
- Stripe Checkout Session
- Stripe Price
- Stripe Invoice Line Item
- QuickBooks Product/Service
- Stripe Payment Links and QuickBooks
More glossary terms
- Undeposited Funds
- Stripe Balance Transaction
- Available vs Pending Balance
- Stripe Dispute
- Stripe Dispute Evidence
- Stripe Fee
- Stripe Balance Adjustment
- QuickBooks Credit Memo
- Stripe Tax
- QuickBooks Tax Code
- Stripe Reserve
- Stripe Tax Rate
- Stripe Fee Credit
- Stripe Credit Note
- QuickBooks Product/Service Item
- Stripe Payout
- QuickBooks Sales Receipt
- QuickBooks Bank Deposit
- QuickBooks Transfer
- Stripe Authorization Hold
- QuickBooks Refund Receipt
- QuickBooks Payment
- QuickBooks Expense
- QuickBooks Journal Entry
- Stripe Financial Account
- Holding Account
- Accounts Receivable
- Bank Feed
- Deferred Revenue
- Stripe PaymentIntent
- Stripe Checkout Session
- Stripe SetupIntent
- Stripe PaymentMethod
- Stripe Charge
- Stripe Refund
- QuickBooks Invoice
- QuickBooks Class Tracking
- QuickBooks Location Tracking
- QuickBooks Project
- QuickBooks Closing Date
- Stripe Invoice Line Item
- Stripe Proration
- Stripe Invoice Status
- Stripe Shipping Rate
- Stripe Transfer
- Stripe Mandate
- Stripe on_behalf_of
- Stripe Invoice Item
- QuickBooks Estimate
- Stripe Invoice Payment
- Stripe Invoice Payment Settings
- Stripe Billing Meter
- Stripe Invoice Template
- Stripe Price
- Stripe Subscription Schedule
- Stripe Subscription Item
- QuickBooks Recurring Transaction
- QuickBooks Sub-Customer
- QuickBooks Audit Log
- QuickBooks Bank Rule
- Stripe Subscription Status
- Stripe Mixed Interval Subscription
- Stripe Trial Settings
- QuickBooks Payment Terms
- Stripe Pending Update
- QuickBooks Tags
- QuickBooks Credit Card Credit
- QuickBooks Vendor Credit
- QuickBooks Bill
- QuickBooks Delayed Charge
- Stripe Billing Mode
- QuickBooks Billable Expense
- Stripe Customer Cash Balance
- QuickBooks Purchase Order
- QuickBooks Opening Balance
- QuickBooks Account Type
- QuickBooks Sales Tax Center
- Stripe Webhook
- Stripe Metadata
- Stripe Outbound Payment
- Stripe Received Credit
- Stripe Outbound Transfer
- Stripe Inbound Transfer
- Stripe Received Debit
- Stripe Payout Method
- Stripe Financial Account Transaction
- Stripe Financial Address
- Stripe Application Fee
- Stripe Connected Account
- Stripe Destination Charge
- Stripe Separate Charges and Transfers
- Stripe Direct Charge
- Stripe Payment Method Configuration
- Stripe Dynamic Payment Methods
- Stripe Payment Method Rules
- QuickBooks Bundle
- Stripe Account Capability
- Stripe Merchant of Record
- Stripe Data Pipeline
- Settlement Currency
- Hosted Invoice Page
- Stripe Customer
- Stripe Product
- QuickBooks Home Currency
- QuickBooks Exchange Gain or Loss
- QuickBooks Trial Balance
- QuickBooks General Ledger Report
- QuickBooks Retained Earnings
- QuickBooks Profit and Loss Report
- QuickBooks Balance Sheet Report
- QuickBooks Account Register
- QuickBooks Reclassify Transactions
- QuickBooks A/R Aging Report
- QuickBooks Sales Tax Liability Report
- QuickBooks Sales Tax Payable
- Stripe Tax Transaction
- Stripe Tax Location Report
- Stripe Tax Summarized Export
- Stripe Tax Itemized Export
- Stripe Product Tax Code
- QuickBooks Vendor
- Economic Nexus
- Reverse Charge
- Stripe Statement Descriptor
- Stripe Taxability Reason
- Stripe Tax Filing Currency
- Stripe Tax Cross-Border Goods Option
- Stripe Tax Threshold Monitoring
- QuickBooks Uncategorized Income
- QuickBooks Sales by Product/Service Report
- QuickBooks Sales by Customer Report
- QuickBooks Group Tax Rate
- Form 1099-NEC
- SEPA Direct Debit
- Bacs Direct Debit
- Canadian Pre-Authorized Debit (PAD)
- Australia BECS Direct Debit
- Stripe PayTo
- Stripe Test Clock
- QuickBooks Customer Display Name
- Backup Withholding
- QuickBooks Multicurrency
- Form 1042-S
- Form W-8BEN
- Form W-9
- Form 8233
- Form 1042
- Form 1099-K
- Form W-8BEN-E
- Stripe Tax Behavior
- Stripe Customer Tax ID
- Form 945
- ITIN (Individual Taxpayer Identification Number)
- Form 1099-MISC
- Stripe Customer Tax Exempt Status
- EFTPS (Electronic Federal Tax Payment System)
- Tax Representative (Fiscal Representative)
- Nil Return
- Sales Tax Exemption Certificate
- EU One Stop Shop (OSS)
- Place of Supply
- Simplified Tax Invoice
- Input VAT (Input Tax)
- Streamlined Sales Tax (SST)
- Fixed Establishment (VAT)
- VIES VAT Number Validation
- E-Invoicing Mandate
- Tax Point (Time of Supply)
- Sales Tax Holiday
- Digital Services Tax
- VAT Invoice (Full Tax Invoice)
- Output VAT (Output Tax)
- VAT Bad Debt Relief
- Sales Tax Sourcing
- Gross Receipts Tax
- VAT Cash Accounting Scheme
- Reduced VAT Rate
- VAT Flat Rate Scheme (UK)
- VAT Annual Accounting Scheme (UK)
- EU VAT SME Scheme
- Making Tax Digital for VAT
- VAT Payments on Account (UK)
- Stripe Tax Registration
- Non-Established Taxable Person (NETP)
- VAT Group Registration (UK)
- Zero-Rated vs Exempt Supply
- Electronically Supplied Services (ESS)
- Zero-Decimal Currency
- UK VAT Registration Threshold
- QuickBooks Deposit Detail Report
- Payment Settlement Entity (PSE)
- QuickBooks Reconcile
- QuickBooks Bad Debt Write-Off
- Stripe Radar
- Stripe Smart Retries
- Stripe Decline Code
- QuickBooks Voided Transaction
- Stripe Minimum Charge Amount
- Stripe 3D Secure
- Stripe Preview Invoice
- Stripe Quantity Transformation (transform_quantity)
- Stripe Customer-Chosen Price (custom_unit_amount)
- Stripe Inline Price (price_data)
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