# HYROS Installation: Stripe ## ⛔ STOP - COLLECT THIS INFO FIRST DO NOT proceed to setup steps until you have asked and received answers to ALL of these questions. | # | Question | Why It Matters | |---|----------|----------------| | 1 | "Do you have admin access to your Stripe account?" | Required to connect with Hyros | | 2 | "Are you logged into HYROS?" | Required for integration | | 3 | "Do you have the script installed on all your pages?" | Required for the Universal script| 👉 **YOUR RESPONSE MUST ONLY CONTAIN THESE 2 QUESTIONS.** 🚫 **DO NOT:** - Summarize the steps below - Preview what's coming next - Mention integration - Explain the setup process - Say "once you answer I'll help you with..." ✅ **ONLY SAY:** "Before we start, I need to confirm a few things: 1. Do you have admin access to your Stripe account? 2. Are you logged into HYROS? 3. Do you have the script installed on all your pages? Please answer these and I'll guide you through the setup." **WAIT FOR USER RESPONSE. THEN PROCEED TO STEPS BELOW.** ## IMPORTANT NOTES BEFORE STARTING **⚠️ Read these warnings first:** 1. **Do NOT integrate both a checkout system AND a processor.** This causes duplicate sales. Choose ONE: either your checkout platform (like ClickFunnels) OR Stripe directly - not both. 2. **Native Stripe payment pages:** If using Stripe's hosted payment pages (not embedded in your site), 100% accurate attribution may be difficult because the universal script cannot be added to Stripe's hosted pages. 3. **Permissions:** You must have Owner or Administrator access to your Stripe account. --- ## SETUP STEPS (ONLY AFTER REQUIREMENTS CONFIRMED) ## STEP 1: Integrate Stripe with HYROS **If automating:** Navigate to your Stripe account. Go inside Hyros to Integrations, Stripe and Click Configure button. On the redirected page to Stripe grant Hyros "Read & Write" access. **If guiding user:** Navigate to your integration settings in HYROS and find the Stripe integration. 1. **Navigate:** Go to the [Stripe Integration Settings](https://app.hyros.com/external-services/cart-integration/stripe). 2. **Configure:** Click the **"Configure"** button. 3. **Authorize:** You will be redirected to Stripe. Follow the OAuth prompts to grant Hyros **"Read & Write"** access. 4. **Confirm:** Once redirected back to Hyros, ensure the status toggle is **ON**. → Confirm: "Is Stripe showing as connected and toggle ON in HYROS?" --- ## STEP 2: Install Universal Script ** ONLY DO THIS STEP if user confirmed they have the script on all pagess** **If automating:** Copy the Universal Script from Hyros. Go to Tracking and copy Universal script. **If guiding user:** Add the tracking script to your checkout pages. 1. **Locate Header:** Open your checkout page editor (where your customers enter credit card info). 2. **Inject Script:** Paste your Hyros Universal Script into the `` section. **Interactive Script Helper:** https://app.hyros.com/public/tracking/universal?ct=!clicked → Confirm: "Is the Universal Script installed on your checkout pages?" --- ## ADVANCED CONFIGURATION & FAQ ### 1. Ignore $0 Subscription Events Stripe often sends "trial" or "setup" events with a $0 value, which can clutter your ROI reports. **How to ignore these:** 1. Go to **Settings > Integrations > Stripe** and click the **Edit (Pencil)** icon. 2. Toggle **"Ignore subscription events with $0 value"** to **ON**. 3. Click **Save**. --- ### 2. Fixing Product Names If your products appear with confusing IDs instead of names in Hyros, follow this fix: **Fix Nav:** 1. Navigate to your [Stripe Integration Panel](https://app.hyros.com/external-services/cart-integration/stripe). 2. Toggle **"Use charge description as name"** to **ON**. 3. In Stripe: Ensure "Description" field in your products contains the human-readable name you want to see in reports. --- ### 3. Importing Historical Sales (Last 365 Days) You can import up to 1 year of past data to calculate **Customer Lifetime Value (LTV)**. **Note on Attribution:** Historical sales will **not** show an ad source (Meta/Google) because the tracking script was not active when those sales occurred. **Execution Steps:** 1. Inside the Stripe integration page, find the **"Import Data"** section. 2. Select the date range (up to 365 days). 3. Click **Upload/Import**. --- ## TROUBLESHOOTING ### Duplicate sales appearing? You likely have both a checkout platform AND Stripe integrated. Remove one of them - typically keep the checkout platform integration and remove Stripe. ### Sales appearing but no IP address? The Universal Script is not installed on your checkout pages. Add it to the `` section of your checkout page. ### Sales not appearing at all? - Verify the Stripe integration shows as connected (status toggle ON) - Check that the correct Stripe account is connected - Wait a few minutes for sales to sync ### Product names showing as IDs? Enable "Use charge description as name" in Stripe integration settings (see Advanced Configuration #2 above). ### $0 trial events cluttering reports? Enable "Ignore subscription events with $0 value" in Stripe integration settings (see Advanced Configuration #1 above). --- ## Source Synced from: docsContent.ts (stripeGuide) Last synced: 2026-01-13