RUTHH COD Form & Upsells Documentation — Ruthh Digital Help Center
RUTHH COD Form & Upsells helps Shopify merchants increase Cash on Delivery conversion and average order value while reducing fake or duplicate orders. Instead of sending buyers through a multi-step checkout, the app provides a fast, customizable one-step COD order form (Popup or Embedded) backed by server-verified discounts, conditional shipping rules, abuse prevention, real-time Google Sheets export, and deduplicated browser + server pixel tracking.
Quick-Start Onboarding Flow
Section titled “Quick-Start Onboarding Flow”Follow these six steps to configure, launch, and verify RUTHH COD Form & Upsells on your Shopify store:
Enable the Theme App Embed ↗
Open the Shopify Theme Editor (Online Store → Themes → Customize → App embeds), toggle on RUTHH COD Form & Upsells, and click Save. No theme.liquid edits are required.
Configure Visibility & Form Fields ↗
Choose Popup or Embedded mode in Visibility Rules, then customize required fields, cascading Country/Province/District selectors, and styling in Form Designer.
Set Up COD Shipping Rates ↗
Create conditional COD delivery tiers by subtotal, weight, product, or region—or import your existing Shopify Shipping profiles in one click.
Enable Offers, Pixels & Sheets ↗
Launch Quantity Offers and Downsells, connect Meta CAPI & TikTok API, configure Fraud Protection, and link Google Sheets.
Place a Test COD Order ↗
Select Save as Draft Order (or Standard COD Order) in General Settings, submit a test order on your storefront, and verify the order tags (COD, RUTHH_COD), shipping line, and Google Sheets row.
Get Support & Feature Status ↗
Use our Troubleshooting Guide, contact [email protected], or review the Module & Feature Status Matrix.
Browse All Documentation Categories
Section titled “Browse All Documentation Categories”1. Getting Started & Visibility
Section titled “1. Getting Started & Visibility”- Product Overview & Architecture — How Admin saves publish revision-locked metafield snapshots to your storefront and how server-authoritative order intake works.
- Installation & Theme App Embed Setup — Activate the Online Store 2.0 App Embed and verify the live status badge on
/app. - Visibility & Display Rules — Configure
PopupvsEmbeddedmode, cart item merging, product/collection rules, subtotal bounds, and fail-safe native button hiding.
2. Form Designer & General Settings
Section titled “2. Form Designer & General Settings”- Form Fields, Validation & Cascading Locations — Reorder form blocks, set required/visible rules, and configure Country → Province → District cascading dropdowns (including all 81 Turkish provinces and districts).
- Appearance, Templates, Typography & Custom CSS — Choose visual presets (
Classic,Modern,Minimal), RTL/LTR/AUTO direction, 19 CTA button animations, and scoped Custom CSS. - Thank You Page Actions & General Order Settings — Configure Standard vs Draft Order creation, Additional COD Fee (fixed or percentage), default tags, UTM pass-through, and post-submit destinations (In-Form Thank You, Custom URL, WhatsApp Redirect, or Order Status Page).
3. COD Shipping Rates
Section titled “3. COD Shipping Rates”- Configuring Conditional COD Shipping Rates — Build conditional COD delivery rates by subtotal, weight, product eligibility, country, and province/state.
- Importing Rates from Shopify Shipping — Import your native Shopify Delivery Profiles in one click and understand currency/carrier skip rules.
4. Sales Booster, Offers & Upsells
Section titled “4. Sales Booster, Offers & Upsells”- Sales Booster Overview & Pricing Evaluation Order — Understand how the 5 conversion modules interact and how the server evaluates discounts and fees in integer minor currency units.
- Quantity Offers (Volume Discounts) — Active tiered quantity discounts with percentage or fixed-amount savings, custom badges, and product/collection targeting.
- Cancel-Intent Downsells — Active recovery modal shown when a buyer attempts to close the COD form before completing their order.
- Product Bundles — Multi-item bundle configuration and
sales-booster/v2snapshot rules (Admin & V2 Snapshot Ready; storefront order-ingress guarded). - One-Tick Upsells & Standalone Service Fees — Single-checkbox product upsells and standalone service fees such as Shipping Protection, Express Shipping, and Gift Wrap (Admin & V2 Snapshot Ready; storefront order-ingress guarded).
- Post-Purchase Upsells — Post-submit one-click offers reconciled via Shopify
orderEditBegin/orderEditCommit(Pilot-flagged behindPOST_PURCHASE_RUNTIME=enabled).
5. Pixels, Orders, Fraud Protection & Google Sheets
Section titled “5. Pixels, Orders, Fraud Protection & Google Sheets”- Meta Pixel (CAPI) & TikTok Events API 2.0 — Browser Web Pixel + server-side CAPI/Events API 2.0 setup with deterministic
event_iddeduplication. - GA4, Google Ads & Pinterest Tag — Client-side funnel and purchase tracking via the native Shopify Web Pixel extension.
- Order Creation Modes & Google Sheets Export — Compare Standard vs Draft COD Orders and connect least-privilege Google OAuth (
drive.file) for real-time order or item-row export. - Fraud Protection, Velocity Limits & Verification — Configure IP/phone/email velocity limits, duplicate order windows, item quantity caps, blocklists, and review the provider-gated SMS/WhatsApp verification workspace.
- Troubleshooting Guide — Resolve form visibility issues,
FORM_CONFIG_REVISION_MISMATCH, shipping mismatches, pixel events, and Google Sheets export errors.
6. Account, Billing, Privacy & Support
Section titled “6. Account, Billing, Privacy & Support”- Plans, Order Allowances & Billing Status — Compare
Free,Basic,Growth, andUnlimitedtiers, 30-day cycle counting, the 24-hour grace window, and pre-launch billing status (BILLING_LIVE_ENABLED = false). - Data Privacy, Retention & GDPR Compliance — Buyer PII minimization, exact retention windows (
24hintent payloads,190dabuse logs,30duninstall purge), and GDPR webhook automation. - Support Channels & Feature Coverage Backlog — Contact Ruthh Digital support (
[email protected]or/support/) and inspect the complete Module & Implementation Status Reference.