Plans, Order Allowances & Billing Status — RUTHH COD Form & Upsells
Goal and Expected Result
Section titled “Goal and Expected Result”Understand how subscription plans, monthly order allowances, usage overage rates, and the one-time 24-hour grace window are structured on the Pricing (/app/pricing) page of RUTHH COD Form & Upsells, as well as the current pre-launch billing status.
Preconditions
Section titled “Preconditions”- You have access to Pricing (
/app/pricing) inside the app in Shopify Admin.
Plan Catalog Overview (app/billing/plans.ts)
Section titled “Plan Catalog Overview (app/billing/plans.ts)”Every plan includes all core application features (Popup & Embedded COD form, Form Designer, Visibility rules, Shipping Rates & Shopify import, Quantity Offers, Downsells, Fraud Protection, Pixels & Server CAPI, and Google Sheets export). Plans scale strictly by monthly COD order volume:
| Plan | Monthly Price | Annual Price | Included COD Orders / 30-Day Cycle | Additional Order Usage Rate |
|---|---|---|---|---|
| Free | $0 / month | — | 100 orders / cycle | No paid overage (includes one 24h grace window per cycle) |
| Basic | $8.99 / month | — | 700 orders / cycle | $0.03 per extra COD order (capped at $100 usage limit) |
| Growth | $24.90 / month | — | 12,000 orders / cycle | $0.03 per extra COD order (capped at $250 usage limit) |
| Unlimited | $44.90 / month | $431.04 / year ($35.92/mo equivalent, 20% off) | Unlimited COD orders | $0 (no usage charges) |
Numbered Instructions: How Order Allowances & Grace Windows Work
Section titled “Numbered Instructions: How Order Allowances & Grace Windows Work”- What Counts Toward Your Cycle Allowance: Only verified COD orders created through RUTHH COD Form & Upsells (Standard COD Orders via
orderCreateor Draft COD Orders viadraftOrderCreate) count toward your 30-day cycle allowance. Regular non-COD Shopify checkout orders are never counted. - One-Time 24-Hour Grace Window on the Free Plan: If a store on the Free plan reaches
100COD orders during a 30-day billing cycle, the app activates a one-time 24-hour grace window (graceEndsAt) instead of cutting off storefront orders immediately—giving the merchant 24 hours to upgrade before new COD submissions are paused for the remainder of the cycle. - Viewing Your Current Usage: Open Pricing (
/app/pricing) at any time to see your current 30-day cycle order count, remaining allowance, and plan status.
Warnings and Edge Cases
Section titled “Warnings and Edge Cases”- Idempotent Retries Are Never Double-Counted: If a network retry submits the same order intent twice, idempotency protection ensures only one order is created and only one order is counted toward your cycle usage.
Troubleshooting Steps
Section titled “Troubleshooting Steps”- Plan upgrade buttons show pre-launch notice on
/app/pricing: This is expected whileBILLING_LIVE_ENABLED = falseduring the pre-release phase; no merchant is billed during pre-launch testing.