Connect ClickBank
This article shows you how to send ClickBank's sales, upsells, rebills, refunds and chargebacks to PlayerMagick, so each sale is matched to the play that sold it.
Available on: Pro, Business and Agency plans.
How it works
ClickBank's Instant Notification Service (INS) sends PlayerMagick an encrypted notification for each order. Only someone with your secret key can create one, so PlayerMagick knows it really comes from your ClickBank account.
PlayerMagick adds pm=… to your buttons' ClickBank payment links. ClickBank carries it through the order and sends it back, so the match is exact. Upsells are matched through their first order.
Before you start
- You need a ClickBank vendor account and one free Instant Notification URL field (ClickBank has two per account). If both are used by other tools, free one or ask the tool's support about forwarding.
- If you have never used INS, ClickBank asks you to request access first (a short form and terms).
Step 1: Connect ClickBank in PlayerMagick
- Go to Settings → Sales platforms and click Connect a platform.
- Next to ClickBank, click Connect.
- Keep the suggested Secret key, or enter the key your ClickBank account already uses (another tool may have set one: don't change it in ClickBank).
- Click Connect. The setup page shows your receiver address. Copy it now: PlayerMagick shows it only once.
Step 2: Set it up in ClickBank
- In ClickBank, open the Accounts tab and click your account nickname.
- Go to Vendor Settings → My Site, then click Edit next to Advanced Tools.
- If you have not done it yet, click Request Access next to Instant Notification URL, fill in the form and accept the terms.
- In Secret Key, enter the same secret key as in PlayerMagick.
- Paste the receiver address into a free Instant Notification URL field.
- Choose version 8.0, click Test URL, then Save Changes.
Step 3: Check it works
- In PlayerMagick, click Send a test sale on the setup page. The result says what a real sale would be matched to. Test sales never count.
- ClickBank's Test URL appears under Recent notifications as "Test received: never counted".
- Test purchases you make with ClickBank's test card show as tests and never count.
Keep the code on your checkout links
Point the player's buttons at your ClickBank payment links (https://VENDOR.pay.clickbank.net/?cbitems=…). PlayerMagick adds pm=… when the viewer clicks. A buy button of your own page, outside the player, doesn't carry the code: those sales are matched by email or counted as not matched.
Notifications that never arrived
ClickBank tries a notification 5 times, 4 hours apart, then drops it for good.
Add the optional API key on the setup page and PlayerMagick checks ClickBank's API every few hours for anything whose notification never reached it. What it finds is counted like any other sale (once: an order PlayerMagick already has is never counted again) and shows in Recent notifications as "Recovered". The line above the list says when PlayerMagick last checked.
- Create the key in ClickBank under Settings → API Management → Create New API Key, with Orders/Tickets API Read. Also fill in Account nickname, so only this account's orders are looked at.
- PlayerMagick looks at sales of the last 4 days that are at least 21 hours old (ClickBank may still retry before that), and at their refunds and chargebacks. The code on your payment links comes back through the API too, so recovered sales are matched exactly.
- Rebills are not recovered.
Troubleshooting
- Refused: the signature didn't match the saved secret. The secret key in PlayerMagick and in ClickBank differ. Enter the same key in both (letters and digits, up to 16).
- Waiting for the first notification after Test URL. Check that you saved the address in ClickBank, chose version 8.0, and pasted the whole address.
- Ignored: role AFFILIATE. Copies ClickBank sends to affiliates or JV partners are not your sales; they are ignored on purpose.
- A rebill doesn't show. Rebills appear as renewals under Settings → Sales platforms, not as new sales of your video.