ConvertPop Installation Guide

Buy ConvertPop

One-time $19. You'll get a unique site ID automatically after checkout.

Buy ConvertPop — $19 →

Create a Stripe Webhook

Tells Stripe to notify ConvertPop every time you get a sale.

Go to Stripe Dashboard → Webhooks and click "Add endpoint". Paste this URL:

Webhook endpoint URL

https://convertpop-api.joseph-boyadjian26300.workers.dev/webhook/YOUR_SITE_ID

Select event: checkout.session.completed

💡 Your site ID was shown on the thank-you page after purchase. Lost it? Email [email protected].

Register Your Webhook Secret

One-time step so ConvertPop can verify your Stripe events are genuine.

After creating the webhook in Stripe, you'll see a Signing secret (starts with whsec_). Copy it, then run this in your terminal:

curl -X POST https://convertpop-api.joseph-boyadjian26300.workers.dev/setup \ -H "Content-Type: application/json" \ -d '{"siteId":"YOUR_SITE_ID","webhookSecret":"whsec_XXXX"}'

⚠️ Do this once, immediately after creating the webhook. Without it, your notifications won't fire.

🔒 Your secret is stored encrypted server-side. It's never exposed in your website code or to your visitors.

Add the Script to Your Site

Paste once — works on every page automatically.

Choose your platform:

Paste before </body> in your HTML:

Go to Appearance → Theme File Editor → footer.php, paste before </body>:

💡 Alternatively, use a plugin like Insert Headers and Footers — paste in the "Footer" field. No theme editing required.

Go to Online Store → Themes → Edit code → theme.liquid, paste before </body>:

⚠️ Make sure your Shopify store uses Stripe as its payment processor — this is required for the webhook to fire.

Go to Project Settings → Custom Code → Footer Code, paste:

Then republish your site.

✓

You're Live

Every completed Stripe checkout now appears as a notification on your site within seconds.

🛡️ ConvertPop shows first name + city only. No email, no purchase amount, no last name. 24-hour auto-delete. GDPR-safe.

Common Questions

What if I have no sales yet?

Nothing shows. ConvertPop only displays real purchases — no fake fallback, ever. Once your first sale comes in, notifications start automatically.

What data is shown in notifications?

First name, city, and time elapsed since purchase. No email, no amount, no last name. Privacy by design.

Do I need to re-run the curl command each time?

No — just once per site. Your webhook secret is stored and reused for every future purchase.

Will it slow down my site?

No. The script is under 5KB and loads asynchronously after your page is interactive.

How long are purchases stored?

24 hours. After that, they're automatically deleted from our servers.

I'm stuck. How do I get help?

Email [email protected] — we reply within 24h.