# Troubleshooting ## Store not ready for subscriptions **Symptoms:** The app says your store is not ready for subscriptions. Shopify has marked your store as not ready to sell subscriptions. It does not tell Tectalic Wine Club why, so check your payment setup first. Subscriptions charge a customer again on a schedule, and not every Shopify payment option supports that. To check your setup: 1. In your Shopify admin, go to **Settings > Payments** 2. Confirm that your payment gateway is fully active. Complete any outstanding account details or verification that Shopify asks for. 3. Check [Shopify's current list of supported subscription payment gateways](https://help.shopify.com/en/manual/products/purchase-options/subscriptions/considerations#supported-subscription-product-payment-gateways). Availability varies by country and the provider's terms. 4. Return to Tectalic Wine Club after you update your payment settings. The warning can take up to 24 hours to disappear. If your gateway is supported and fully active but the warning remains, contact Shopify Support and ask them to check whether your store is configured to sell subscription products. Tectalic Wine Club receives the status from Shopify, but not the reason behind it. !!! info "PayPal and test gateways" PayPal Express is the supported PayPal option for subscriptions. Shopify's Bogus Gateway cannot process subscription products. Use Shopify Payments in test mode when testing on a development store. ## Signup widget not displaying **Symptoms:** The wine club signup widget does not appear on your storefront. **Solutions:** - Ensure at least one club is **published**. Draft clubs do not appear in the widget. See [Managing Clubs](managing-clubs.md) for details on publishing. - Ensure the **Tectalic Wine Club** theme block has been added to the page in the Theme Editor (Online Store > Themes > Customize). See [Setting Up Your Landing Page](landing-page.md) for step-by-step instructions. - Check that the page is published and accessible to customers. - For Curated clubs, verify that all products in each club are available (in stock, published, and active). Clubs with unavailable products are hidden automatically. See [Managing Clubs — Changing Products](managing-clubs.md#changing-products) for more details. ## Customer portal not showing **Symptoms:** Customers cannot see the Subscriptions section in their account. **Solutions:** - Ensure the customer portal extension blocks have been added to your customer account pages via the theme editor. See [Installation — Enable Customer Portal](installation.md#3-enable-customer-portal) for setup steps. - Shopify has retired the old customer accounts system. Tectalic Wine Club requires the new customer accounts to work. Go to **Settings > Customer accounts** in your Shopify admin to upgrade. [Learn more about upgrading](https://help.shopify.com/en/manual/customers/customer-accounts/upgrade). See [Installation — Verify Store Requirements](installation.md#1-verify-store-requirements) for the full list of prerequisites and [Customer Portal](customer-portal.md) for details on what customers can access. ## Delivery options missing **Symptoms:** The Change delivery modal only shows standard shipping, even though local delivery or winery pickup is enabled. **Solution:** Your fulfillment location needs a complete street address. Shopify requires a full address to calculate local delivery and pickup availability. 1. Go to **Settings > Locations** in your Shopify admin 2. Click on your fulfillment location 3. Ensure a complete address is configured (street, city, state/province, postal code) 4. Save the location See [Customer Portal — Change Delivery](customer-portal.md#change-delivery) for more about how delivery options work for customers. ## Mobile display issues **Symptoms:** The signup widget or portal does not display correctly on mobile devices. **Solutions:** - The app uses responsive design and should adapt to all screen sizes automatically - Check for CSS conflicts in your theme that may override the widget's styles - Try the widget in a different browser to rule out browser-specific issues ## Purchase type option missing from a discount **Symptoms:** When creating a Shopify automatic discount, the **Purchase type** selector (Subscription / One-time purchase) doesn't appear. **Solution:** Shopify hides the Purchase type selector until you have a published club. Publish a club, then create the discount. See [Setup — Free shipping for subscribers](setup.md#free-shipping-for-subscribers) for the steps. ## Checkout validation not working **Symptoms:** Customers can modify their cart in ways that should be blocked (e.g., removing bottles from a curated case). **Solution:** Ensure the checkout validation rule is enabled: 1. Go to **Settings > Checkout** in your Shopify admin 2. Under **Checkout rules**, verify that the **Tectalic Wine Club** rule is enabled See [Launching Your Wine Club](launching.md#1-test-the-complete-flow) for the full pre-launch testing checklist. ## Subscription charging an old card after a Shop Pay update **Symptoms:** A customer changed their card details in the Shop app, but their subscription still charges the old card — or their payment keeps failing. Shop Pay cards are managed by the customer in the Shop app or at [shop.app](https://shop.app). What happens next depends on how they changed their details: - **Edited the existing card** (for example a new expiry date) — the update applies to their subscription automatically. Nothing further is needed. - **Added a new card** — existing subscriptions stay on the old card. Ask the customer to open their subscription in the [customer portal](customer-portal.md#update-payment) and select the new card under **Update payment method**. If the customer's payment is failing and they can't resolve it in Shop Pay, send them a secure update link from the subscription page — see [Update payment method](managing-subscriptions.md#update-payment-method). !!! info Shop Pay allows only a couple of card updates within a short window. If a customer sees "We had trouble updating your payment info", have them wait 20 minutes and try again.