Skip to content

Create a price list with base prices and optional quantity breaks, then assign it to a customer with price_list_id or to a segment label through customer_segments. Set the customer's segment to the same label for segment pricing. All assignments and prices belong to one merchant environment.

Choose a price#

For each catalog variant line, Flint checks these sources in order:

  1. The customer's directly assigned list, when active and pricing that variant.
  2. The active list for the customer's segment, when it prices the variant.
  3. The variant's default schedule.

Flint selects the break with the largest minimum_quantity at or below that line's quantity, or the schedule's base price. Separate lines do not combine quantities. An inactive list provides no prices. Archived lists cannot be used for pricing.

The resulting net price becomes unit_price_money. The line stays linked to its catalog variant, and catalog_pricing reports the source, list ID, and applied break. Promotions discount that net price plus modifiers and follow their usual combination rules. Lists do not count toward max_promotions_per_order. Use customer.segment promotion rules to exclude wholesale buyers from a promotion.

Freeze and refresh terms#

Orders freeze the chosen schedule. Quantity changes on open orders select from that frozen schedule; later catalog or list edits do not change it. A quantity edit cannot change the unit price after payment has been received. Subscription renewals keep their locked prices.

On an open, unpaid order, send catalog_price_behavior: "reprice" with an explicit non-null customer_id to refresh all catalog variant lines. Reassigning resolves the new customer's direct list, segment list, and variant fallback. The default keep preserves frozen prices. Customer removal is not supported.

Supply the customer before checkout#

Negotiated prices apply to order creation and line additions, invoice quick_pay lines, subscription offers and subscription line additions or swaps, and return exchanges using current_price. Authored subscription plans keep their own prices. Payment links and orders without a customer use variant schedules.

Checkout never reprices after customer verification. Supply the customer when creating the order. Buyers see the net prices on their own orders, invoices, and subscriptions. Price lists, customer assignments, and each line's catalog_pricing remain merchant-only.

Was this helpful?