One-Tick Upsells & Independent Service Fees — RUTHH COD Form & Upsells
Goal and Expected Result
Section titled “Goal and Expected Result”Configure single-checkbox One-Tick Upsells in Sales Booster → One-Tick Upsells (/app/sales-booster/one-tick-upsells) for either complementary catalog products (PRODUCT_BACKED) or standalone service fees (INDEPENDENT_FEE: Shipping Protection, Express Shipping, and Gift Wrapping).
Preconditions
Section titled “Preconditions”- You have access to Sales Booster → One-Tick Upsells (
/app/sales-booster/one-tick-upsells).
Numbered Instructions
Section titled “Numbered Instructions”1. Choose a One-Tick Template & Commercial Model
Section titled “1. Choose a One-Tick Template & Commercial Model”- Open Sales Booster → One-Tick Upsells (
/app/sales-booster/one-tick-upsells) and click Create upsell. - Select the template and commercial model:
- Product-Backed Upsell (
PRODUCT_BACKED): Adds a real Shopify product/variant when the buyer ticks the checkbox. - Independent Service Fee (
INDEPENDENT_FEE): Uses one of three dedicated templates—SHIPPING_PROTECTION,EXPRESS_SHIPPING, orGIFT_WRAPPING—withproductGid: null,variantGid: null,requiresShipping: false, a positiveFIXED_PRICE, and a configurabletaxablesetting.
- Product-Backed Upsell (
2. Configure Product Selection, Variants & Quantity (Product-Backed Only)
Section titled “2. Configure Product Selection, Variants & Quantity (Product-Backed Only)”- Select a product using the Shopify Resource Picker.
- Choose the Variant Selection Mode:
- Locked Variant: Offers a single specific variant (
variantGid). - Buyer Selects (
variantMode: "BUYER_SELECTS"): SetsvariantGid: nulland emitsproductHandleso the buyer can choose their preferred size/color variant; the server authorizes the submitted variant against the configured product.
- Locked Variant: Offers a single specific variant (
- Optionally include the
{{Product_Name}}token in the offer Title (populated from the authoritative ShopifyproductTitleat save time). - Optionally enable the Buyer Quantity Selector (
quantity.selectorEnabled: true) with integer bounds1 <= min <= max <= 10. (Independent fee offers always have fixed quantity1/1.)
3. Configure Targeting, UTC Schedule & Presentation
Section titled “3. Configure Targeting, UTC Schedule & Presentation”- Under Targeting, select:
ALL_PRODUCTSSPECIFIC_PRODUCTSSPECIFIC_COLLECTIONS(up to25canonical Shopify Collection GIDs; supported on both product-backed and independent fee entries).
- Under Schedule, choose
ALWAYSorSCHEDULEDwith UTC start (startAt) and end (endAt) instants (startAt <= now < endAt, end exclusive). - Customize the checkbox card presentation (
one-tick-presentation/v1: title, subtitle, badge, checkbox style, and pre-checked state) and click Save.
Warnings and Edge Cases
Section titled “Warnings and Edge Cases”Troubleshooting Steps
Section titled “Troubleshooting Steps”{{Product_Name}}token is not available on fee templates: Because independent fee entries (SHIPPING_PROTECTION,EXPRESS_SHIPPING,GIFT_WRAPPING) have no associated Shopify product,productTitleis omitted and prohibited on fee entries.- Scheduled offer is not active: Verify that your
startAtandendAttimestamps are entered in UTC and that current time satisfiesstartAt <= now < endAt.