Connect ThriveCart
This article shows you how to send your ThriveCart orders, bumps, upsells, renewals and refunds to PlayerMagick, so each sale is matched to the play that sold it.
Available on: Pro, Business and Agency plans.
How it works
ThriveCart sends PlayerMagick a webhook for each order, subscription payment, refund and cancellation. Every webhook carries your account's secret word; PlayerMagick checks it, so nobody else can send you fake sales.
PlayerMagick adds passthrough[pm]=… to your buttons' ThriveCart checkout links. ThriveCart passes it through the checkout and sends it back, so the match is exact. An order bump counts with its order; each upsell or downsell is its own sale, matched through its first order.
ThriveCart doesn't send chargebacks, so they can't be counted automatically.
Before you start
- ThriveCart allows 5 webhook addresses per account by default. If all 5 are used by other tools, remove one or ask ThriveCart for more.
Step 1: Connect ThriveCart in PlayerMagick
- In ThriveCart, open Settings → API & Webhooks. Under ThriveCart order validation, copy your Secret word.
- In PlayerMagick, go to Settings → Sales platforms and click Connect a platform.
- Next to ThriveCart, click Connect, paste the secret word into Secret word, and click Connect.
- The setup page shows your receiver address. Copy it now: PlayerMagick shows it only once.
Step 2: Add the webhook in ThriveCart
- In ThriveCart, open Settings → API & Webhooks.
- Under Webhooks & Notifications, add a webhook named PlayerMagick and paste the receiver address as its URL.
- Save it. ThriveCart checks the address before adding it, and PlayerMagick answers that check.
Step 3: Check it works
- Click Send a test sale on the setup page. The result says what a real sale would be matched to. Test sales never count.
- Purchases in ThriveCart's test mode show as tests and never count.
Keep the code on your checkout links
Point the player's buttons at your ThriveCart checkout links (https://….thrivecart.com/…). PlayerMagick adds passthrough[pm]=… when the viewer clicks. If your link already has its own passthrough[pm], PlayerMagick leaves it alone.
Checkout on your own domain or embedded on your page. PlayerMagick recognises ThriveCart links on thrivecart.com. If the player's button goes to your own page with an embedded ThriveCart cart, the page receives pm=… in its address. Add this line to that page right after the cart's embed <div …> (before ThriveCart's own script tag), so the embedded cart gets the code too:
<script>(function(){var p=new URLSearchParams(location.search).get('pm');if(p&&/^[\w-]{22}$/.test(p))document.querySelectorAll('[data-thrivecart-account]').forEach(function(e){var q=e.getAttribute('data-thrivecart-querystring');e.setAttribute('data-thrivecart-querystring',(q?q+'&':'')+'passthrough[pm]='+p)})})();</script>
Without it, those sales are matched by the buyer's email or counted as not matched.
If ThriveCart charges your Stripe account and you connect Stripe too, PlayerMagick skips a payment another connection already counted when ThriveCart sends the payment's id. If you see the same sale twice, turn off Count sales from this connection on one of them.
Troubleshooting
- ThriveCart says the webhook can't be added. Paste the whole address, exactly as PlayerMagick showed it. If you lost it, click Regenerate address.
- Refused: the signature didn't match the saved secret. The secret word changed in ThriveCart. Copy it again and save it on the setup page.
- Already recorded. ThriveCart sent the same order again (for example a retry). It is counted once.
- Order not found (it may arrive later). A refund arrived before its order. PlayerMagick looks again for up to a day.