Order limits & overflow billing

Llama Upsell does not bill you for every order in your store. It only counts orders that one of your offers actually helped create — and only those count toward your monthly allotment or trigger any per-order fee. This page is the definitive explanation of what counts as a billable order, how your included orders reset each cycle, when overflow fees kick in, and how the monthly spending cap protects you.

What counts as an order

The single most important rule: only an order that contains at least one product attributed to a Llama campaign is counted. A normal order with no upsell or cross-sell line item is not counted and is never billed.

So if a customer buys only items they would have bought anyway — with no product added by one of your offers — that order does not increase your count and you pay nothing extra for it, no matter how large the order is.

How an order gets attributed

Attribution happens in one of two ways, depending on where the offer ran. Each one increments your shop's order count by exactly 1 per order — never more, even if several offers contributed to the same order.

In both cases, the system reads the campaign reference, confirms a campaign-attributed product is present, and adds 1 to your order count for that order.

Your monthly included orders

Every plan comes with a number of included orders per billing cycle. As long as your attributed orders stay at or below this allotment, you pay only your flat monthly plan fee — no per-order fees at all.

These allotments reset at the start of each billing cycle. The reset is anchored to your last billing date, so your counter returns to zero when a new cycle begins and you get the full allotment again.

Where to see your usage

On the subscription page inside the app, your usage is shown as a current count against your plan's maximum:

• currentOrders vs maxOrders — your recurring subscription's attributed-order count for this cycle versus your plan's included allotment. This is the number to watch: when currentOrders passes maxOrders, overflow billing begins.
• usageSubscription.orders — the order count tracked on the usage side of your subscription, used to calculate any per-order charges.

What triggers overflow

Once your attributed orders exceed the included allotment in a cycle, each additional attributed order incurs your plan's per-order fee. Orders inside the allotment are always free; only the ones beyond it are charged.

The per-order fee gets smaller on higher plans. If your overflow fees are adding up, it can be cheaper to move up a tier: the higher plan's larger allotment plus its lower per-order fee may cost less overall than staying put.

Worked example

A store on the Growth plan gets 2,000 included orders per cycle.

Suppose this cycle generates 2,150 attributed orders:

• The first 2,000 are covered by the included allotment — $0 in per-order fees.
• The remaining 150 are overflow, billed at the Growth per-order fee of $0.015 each.
• Overflow charge: 150 × $0.015 = $2.25, added as usage charges on top of the $19.99 monthly fee.

So that cycle's total would be $19.99 + $2.25 = $22.24.

The monthly cap

Per-order (usage) charges can never run away on you, because Shopify enforces a monthly capped amount per plan. This is the maximum total in usage charges the app can bill you in a single cycle.

As overflow orders accrue, their fees add up (withdrawAmount) toward your plan's cappedAmount. The cap covers only usage (per-order) charges — your flat monthly plan fee is separate and is not counted against the cap.

How charges appear

There is no separate card or invoice for Llama Upsell. Both parts of your bill — the recurring monthly plan fee and any usage (per-order) charges — flow through Shopify's billing system via the Mantle billing integration, and land on your regular Shopify invoice.

That means you manage and pay for the app exactly the way you pay for Shopify itself, and you can review the recurring charge and the usage charge as line items on your Shopify bill.

Edit, refund & duplicate behavior

A few edge cases affect how orders are counted. Read these before you try to reconcile your Llama count against Shopify.

Orders are deduplicated at the document level by Shopify order ID — the same order ID is stored as a single order document rather than duplicated. This keeps your stored order list clean even when the same order is delivered or processed more than once.

Estimate your monthly cost

Use this simple recipe to estimate what you'll pay in a cycle:

estimated cost = monthly fee
               + max(0, attributedOrders − includedOrders) × perOrderFee

…then cap the per-order portion at the plan's cappedAmount.

Example (Pro plan): 2,600 attributed orders, 2,000 included → 600 overflow × $0.01 = $6.00 in usage charges (well under the $500 cap). Total estimate: $99.99 + $6.00 = $105.99.

FAQ

Related guides