PowerHQ Partner Network

PowerHQ iFrame — Partner Onboarding Guide

Everything you need to go from sign-up to live energy enrollment on your site — styled to your brand, with no engineering required. Answer the highlighted questions as you read — at the end of the page you'll review everything and submit it to your partner manager. Completing this form is the first step: once you submit, we send your agreement to sign. Your answers are saved in this browser as you go.

What you're getting

The PowerHQ iFrame embeds our proven energy shopping and enrollment experience directly into your website. Your visitors compare plans, sign up, and complete enrollment without leaving your site — PowerHQ handles the supplier relationships, regulatory and compliance layer, enrollment operations, and customer service behind the scenes.

All deregulated states, dynamically supported. The experience automatically adapts to the customer's market.
Residential and business customers. Both are supported by default; you can choose to support only one customer type.
Your brand. We configure fonts and colors to match your site, and emails can carry your name.
Built for conversion. A personalized, continually optimized UX that routes each customer to the right shopping path.

Onboarding at a glance

1
Complete this formYou're here
Answer the questions on this page, then submit at the bottom.
2
Sign the agreement
We send it for signature once you submit this form.
3
We set you up
4
Test links + IP whitelist
5
You test
6
Go live

Typical timeline: live in days, not months.

1Complete this set-up form

Start here. Work through the highlighted questions on this page, then review and submit at the bottom. Submitting this form is what kicks everything off: as soon as it's in, your PowerHQ partner manager prepares your agreement and sends it to you for signature.

2Sign the partner agreement

Signing the partner agreement is required before you can go live. Once you submit the form above, your partner manager sends the agreement — including Exhibit A, which sets your compensation terms — for your review and signature. Formal onboarding begins the moment it's signed, and your PowerHQ contact kicks off setup immediately after.

3We set up your partner profile

PowerHQ configures your experience — there's nothing for your engineering team to build. Answer the questions in each block and we'll have what we need.

Branding

We apply your font and colors to the embedded experience so it looks native to your site.

Your set-up — branding

Brand color

Font used on your site

Tip: this page previews your choices — the green accents will switch to your brand color, and the page text will switch to your font.

Email sender name

Customer emails (order confirmations, enrollment updates) can be sent under a custom email name of your choosing. The default sender is PowerHQ.

Your set-up — email sender

PowerHQDefault sender name Custom nameYour brand on customer emails

Partner codes — parent and child

You receive a unique partner code. If you want to track activity separately — by site, channel, campaign group, or sub-brand — we can set up a parent code with multiple child codes. Every conversion is reported with the code (parent or child) that produced it.

Your set-up — partner codes

Single codeOne code for everything Parent + childrenTrack segments separately

Customer types

By default your iFrame supports both residential and business customers. If you prefer to serve only one customer type, we configure that — or you can use the type-specific links below to control it per placement.

Your set-up — customer experience

BothResidential + business (default) Business only Residential only

4Receive your test links & whitelist your IPs

We provide links to our test environment so you can experience exactly what your customers will see.

IP whitelisting required: the test environment is access-restricted — no part of the test iFrame experience is reachable from an IP we haven’t whitelisted. Add them below if you have them now, or send them to your partner manager later — either way, we need them before you can start testing. Production links don’t require whitelisting.

Send every IP address your team will test from:

Office — your office’s static IP address or range
VPN — the exit IP address, if anyone tests while connected to a VPN
Remote testers — the IP address of anyone testing from home or another location

Not sure of your IP address? Search “what is my IP” while connected to the network you’ll test from.

Your set-up — test access

IP address(es) to whitelist — optional now, needed before testing

How the link is structured

Every iFrame link follows the same structure — we'll send yours pre-built, but here's what each piece does:

https://www.cert.powerhq.co/partner-app.html?utm_source=[PARTNER_CODE]&utm_medium=referral&utm_campaign=[CAMPAIGN]#/[partner_code]?ftype=DEFAULT_PARTNER&service_type=[TYPE]&zip_code=[ZIP]

Piece	What it does
`utm_source=[PARTNER_CODE]`	Your assigned partner code (parent or child). Identifies you on every conversion.
`utm_medium=referral`	Fixed — leave as is.
`utm_campaign=[CAMPAIGN]`	Any value you choose for marketing attribution — passed through to your reports. See Reporting below.
`#/[partner_code]`	Your partner code again, lowercase.
`ftype=DEFAULT_PARTNER`	Fixed — leave as is.
`&service_type=[TYPE]` (optional)	`BUSINESS` or `RESIDENTIAL` to limit a placement to one customer type. Omit to support both.
`&zip_code=[ZIP]` (optional)	Pre-loads a zip code you've already collected on your site. See Embedding tips.

You can place links with different parameters in different parts of your site — e.g., business-only on your commercial pages, residential-only on your consumer pages. Production links use the same structure on the production domain.

Embedding tips

Use this embed code

Paste this where you want the experience to appear, replacing [YOUR PARTNER LINK] with the link we send you:

<iframe
  src="[YOUR PARTNER LINK]"
  title="Compare electricity plans"
  style="width:100%; height:900px; border:0; display:block;">
</iframe>

Width and height

The experience is responsive, so keep the width at 100%. Always set a height — without one, browsers default an iFrame to 150px, which hides everything except the header.

Desktop: 800–900px
Mobile: most of the screen height, e.g. height:90vh; min-height:650px

Height & scrolling

The iFrame doesn’t grow to fit its content. It fills the height you give it and scrolls inside that space — on plan results, the plan list scrolls within the iFrame while your page stays put. Give it a generous height, and avoid shrinking it with CSS zoom or scale: the text gets hard to read and it still scrolls internally.

Pre-loading a zip code

If you already collect a zip code on your site, pass it into the iFrame so the customer doesn't have to enter it again. Just append the following to the end of the iFrame URL:

&zip_code=[zipcode]

For example, if the zip code is 75035, add &zip_code=75035. The full URL would look like:

https://www.cert.powerhq.co/partner-app.html?utm_source=[PARTNER_CODE]&utm_medium=referral&utm_campaign=[CAMPAIGN]#/[partner_code]?ftype=DEFAULT_PARTNER&service_type=RESIDENTIAL&zip_code=75035

This pre-fills the zip code so the customer doesn’t have to re-enter it. They still click Continue and answer a few questions about their service before plan results appear.

Setting the zip code with JavaScript? Build the full iFrame src, including zip_code, before the iFrame loads. Changing only the part of the link after the # on an iFrame that’s already loaded may not take effect.

Your set-up — zip code

Will you pass a zip code into the iFrame?

5Test the experience

From a whitelisted IP, place the iFrame on a staging page (or open the link directly) and run through the shopping and enrollment flow as a customer would. Confirm:

The zip code form and Continue button are fully visible without scrolling your page
On plan results, at least 3 plan cards are visible on desktop
On a phone, the plan list scrolls smoothly and your page can still be scrolled past the iFrame
Price and Select Plan are fully visible on each plan card at phone width
If you pass &zip_code=, the zip code appears pre-filled
Branding (font, colors) looks right within your site
The correct customer type(s) appear for each placement
Your partner code and utm_campaign values flow through to the daily conversion file

Your PowerHQ contact will work with you through any adjustments.

6Go live

Once you've tested successfully, we provide your production link(s) — same structure, production domain. You can go live immediately.

Reporting & attribution

You'll receive three reports:

Report	What it gives you	Cadence
PostHog dashboard	Funnel and traffic analytics for your experience. Example dashboard	Near real-time
Daily conversion file	Every conversion with order details, your partner code (parent or child), and the `utm_campaign` value — designed for marketing attribution.	Daily
Monthly commission report	Detail on every conversion and the payments owed to you, including partner code and `utm_campaign`.	Monthly

Daily conversion file — fields

Order ID, Conversion DateTime, Estimated Conversion Value, Customer Name, UTM Campaign, Referral Code (your partner code), Term Length, Start Date, Annual Usage, Customer Type (RESIDENTIAL / BUSINESS).

Attribution tip: whatever value is in utm_campaign at conversion is passed through to the daily conversion file and commission report. Partners use this two ways: some pass the marketing campaign info directly (campaign name, placement, ad set), while others pass a unique ID and match it back to the marketing source in their own systems. Either works — use whatever fits your attribution setup. Combine with child codes for a second tracking dimension.

Your set-up — attribution

How will you use utm_campaign?

Campaign infoCampaign name / placement / ad set in the parameter Unique IDWe'll match IDs to sources in our own systems Not sure yetWe'll figure it out during testing

Complete your set-up

Just what we need to prepare your agreement.

Company details

Company legal name *

Company address

Main telephone

Website address *

Authorized signatory

The person who will sign the partner agreement on behalf of your company.

Name *

Position / title

Phone

Email *

Payment details come later. Your partner manager will collect your banking information and W-9 through a secure channel before your first commission payment — no need to provide them here.

Anything else?

Notes for your partner manager — optional

Review & submit

Everything you've answered throughout this page, in one place. Review it, then hit Submit to send it to your PowerHQ partner manager.