Manually Activating Subscription Contracts

Manually Activating Subscription Contracts

During the migration process, it’s possible that a small number of member contracts may fail to activate automatically. If this occurs, you will be notified via email with a list of the affected contracts.

In Winehub, unactivated contracts will display a red warning banner at the top of the contract screen within Winehub (see below). These contracts will remain in DRAFT status until resolved. You’ll need to follow the appropriate steps to ensure these contracts are successfully activated and ready to generate club orders.


Reasons why Shopify might reject an activation & How to Fix Them

  1. No Payment Details in Stripe
    The customer does not have any saved payment details in Stripe.
    Solution: Contact the customer and request updated payment details. Use the Create section within the customer profile in Winehub to vault the new card. Then, activate the contract in Shopify (see below).

  2. Email Address Mismatch
    The customer email in Stripe does not match the customer email in Shopify.
    Solution: Update the Stripe customer record so the email matches the one in Shopify. Then use the Create section in the Winehub customer profile to Sync with Stripe and activate the contract in Shopify (see below).

  3. Duplicate Stripe Accounts
    The customer has multiple Stripe accounts using the same email address.
    Solution: Remove unnecessary customer accounts in Stripe and ensure only one account contains the correct email and payment information. Then return to Winehub to Sync with Stripe and activate the contract (see below).

  4. Invalid Customer Details
    The customer address or phone number is missing, incorrect, or improperly formatted.
    Solution: Update the subscription contract record with valid details in the correct format. If your Shopify settings have phone number as a mandatory field, this must be entered when editing the subscription address before activation. Then proceed to activate the contract (see below).

InfoAny other contract activation issues not listed above will be detailed in the notification email provided after migration.

Sync Payment Methods (Stripe)

After making any changes to customer records in Stripe, you will need to sync the two platforms to fetch the updated card details back into Winehub. If you have a large number of customers, this can take some time to process so ensure you have updated all the records you need to in Stripe before beginning the sync. Navigate to Third Party Integrations in the Settings page of Winehub and choose Stripe. Click the button labeled Sync All Stripe Customers and Cards to Shopify.

Activate Contract in Shopify

Once customer card details are visible in the Create section of the Winehub customer profile, you can activate the contract in Shopify. To do this:

  1. Go to the Subscriptions tab within the customer profile.

  2. Click the edit icon on the relevant contract.

  3. From the More Options menu at the top of the page, select Activate Contract.


What you can do with unactivated contracts

  1. update the customer's payment method
  2. update the customer's address
  3. update the customer's selection
  4. pause the customer's contract
  5. cancel the customer's contract

What you can't do with unactivated contracts

  1. process club shipments
  2. generate scheduled club shipments
  3. view subscription data in Shopify like club tags



    • Related Articles

    • Customer Contracts

      Contracts are where you will find all wine club subscriptions. Use the filters on this page to report on contracts by name, club, frequency, status or created date. View Contract When you view a subscription contract you can view the following ...

    • Updating Subscription Addresses

      Like most eCommerce platforms, Shopify supports multiple customer addresses, with one always designated as the "default." While wine club subscriptions are typically sent to the customer's default address, this isn’t always the case. Some customers ...

    • Stripe

      Winehub integrates directly with Stripe to securely sync stored customer payment methods into Shopify - enabling seamless subscription and wine club management without unnecessary reprocessing. Stripe is also a key part of our migration pathway for ...

    • Migration Overview

      We understand that transitioning to a new platform can feel overwhelming. That's why we offer an optional migration service to help you bring your existing members across from another platform. This is a bookable service designed to make the ...

    • Customer Profile

      The Customer Profile in Winehub provides a comprehensive, tabbed view of each customer, including contact details, subscription activity, loyalty status, order history, benefits, payment methods, notes, and automated communications. Some information ...