Cercle Bundle setup and compatibility
Cercle Bundle manages one choose-your-own bundle programme per Shopify store. It is a one-time purchase builder, with products and quantities chosen by the shopper.
Before installing
This release requires a Pakistani rupee store and a compatible Hydrogen storefront. The supplied reference integration targets Hydrogen 2026.4 with React Router 7. A developer must connect it once. Other Hydrogen versions need a developer compatibility check.
A shop can have both Online Store and Hydrogen. Installing Cercle Bundle does not add a builder to a Liquid theme. This release has no theme app block or POS integration. The Online Store requirement in the listing is therefore left unchecked.
The catalogue limit is 1,000 variants. Bundles support up to 100 different variants and 500 packs, within the merchant’s lower configured limits. A pack means one saleable unit of a variant. Supported unit and compare-at amounts are at most PKR 1,000,000; a bundle’s merchandise total is at most PKR 10,000,000. Product variants must be available through the connected Hydrogen storefront. The reference integration uses the Pakistan market and Pakistani rupees.
Owner setup
- Install through Shopify and open Cercle Bundle in Shopify Admin. The store owner reviews the privacy policy and merchant data agreement. Development stores use a clearly labelled, non-binding test flow.
- Save the programme in Settings. Select eligible variants in Products. Configure savings tiers, exclusions and optional dates in Savings. New programmes start as drafts with savings off.
- Open Overview and create a connection credential. Give it only to the developer configuring the Hydrogen server. It is shown once. Never paste it into a browser bundle or a public environment variable.
- After the developer has connected the builder, choose Active in Settings, save, and select Sync checkout savings in Overview. Repeat sync after changing rules. Saving alone does not publish checkout changes.
- Test a qualifying bundle and a separate purchase of the same variant together. Only signed bundle lines receive the bundle discount. Check the final amounts in Shopify Checkout.
Developer connection
Download the Hydrogen reference integration. Its README contains the file list, cart requirements, secret configuration and verification steps. Merge it into a development branch and verify it on the same Shopify store before release.
Set CERCLE_BUNDLE_API_URL and CERCLE_BUNDLE_CONNECTION_TOKEN only in the Hydrogen server environment. PUBLIC_STORE_DOMAIN must match the installing store. Publish the chosen products to that storefront. The supplied route uses the existing Hydrogen cart and Shopify Checkout; it does not create draft orders or process payments.
Staff and reports
Staff need Shopify permission to open the app. They request access inside Cercle Bundle. The owner assigns Manager or Viewer under Access. Managers can edit and sync; viewers can read. Shopify permissions remain enforced. Remove app access when it is no longer needed.
Reports read the last 7, 30 or 60 days of Shopify orders on demand. Load additional pages when indicated. Paid bundle values exclude cancelled, refunded or changed bundle lines, shipping and separately charged tax. Reports use Pakistan time and exclude test orders outside development stores. No customer names or contact details are requested for reporting.
Pausing and disconnecting
To pause discounts while retaining the builder, turn off bundle discounts, save and sync. To hide the builder, set the programme to Draft, save and sync. To replace a credential, first pause discounts and sync, then create a new credential, update the Hydrogen secrets and verify the connection. Uninstalling revokes the connection and staff assignments.
Troubleshooting
If products do not load, check the store currency, variant limit, product status, publication to Hydrogen and Shopify staff permissions. If savings are unavailable, verify the connection, save and sync, then create a fresh bundle. Other automatic discounts cannot combine with the bundle discount in this release. Sale exclusions use the current price and compare-at price.
The app backend must remain online. The current review service is operated on Fourbit’s Mac mini through its HTTPS service. Merchant storefront hosting is separate and must also remain available.
Support: support@bestselection.pk. Privacy policy · Merchant data agreement.