Connect ClickFunnels 2.0
This article shows you how to send your ClickFunnels 2.0 orders, renewals, refunds and cancellations to PlayerMagick, so your sales are matched to the plays that sold them.
Available on: Pro, Business and Agency plans.
How it works
ClickFunnels sends PlayerMagick a webhook for each order event in your workspace. Each one is signed with your endpoint's webhook secret and a time stamp; PlayerMagick checks both, so nobody else can send you fake orders or replay old ones.
ClickFunnels doesn't send a link code back with its orders, so sales are matched by email: the buyer gave the same email address to one of your videos or funnels and watched in the 7 days before buying. Orders without such a viewer are counted as not matched. The log shows which funnel and page took each order.
- One-time orders count when they are paid; subscriptions count at their first payment, and later payments are shown as renewals.
- Full refunds are subtracted. ClickFunnels doesn't say how much a partial refund was, so a partial refund marks the sale as partly refunded and the log says Partial refund, amount unknown. The sale still counts with its full amount.
Before you start
- Webhooks need the ClickFunnels Scale plan or higher.
Step 1: Connect ClickFunnels in PlayerMagick
- Go to Settings → Sales platforms and click Connect a platform.
- Next to ClickFunnels 2.0, click Connect, then Connect again.
- The setup page shows your receiver address. Copy it now: PlayerMagick shows it only once.
Step 2: Create the endpoint in ClickFunnels
- In ClickFunnels, open Workspace Settings → Webhooks and click Add New Endpoint.
- Name it PlayerMagick and paste the receiver address as the URL.
- In Event Types, select one-time-order.completed, subscription.invoice.paid, one_time_order.refunded, orders/invoice.refunded and subscription.canceled.
- Choose API version V2. Leave Endpoint Scopes empty, or pick the funnels whose sales PlayerMagick should count, and save.
- Open the endpoint and copy its webhook secret.
Step 3: Save the secret in PlayerMagick
On the setup page, paste it into Webhook secret and click Save.
Step 4: 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.
- ClickFunnels has no test button. Place an order in test mode: it appears under Recent notifications as a test. The endpoint's Deliveries in ClickFunnels shows what was sent.
Help email matching
Email matching works when the buyer gave their email to PlayerMagick before buying: an email gate on the video, or a funnel question that asks for it. The more of your viewers PlayerMagick recognizes, the more orders are matched.
Troubleshooting
- Refused: the signature didn't match the saved secret. Copy the webhook secret again from the endpoint's page in ClickFunnels.
- Refused: too old. The notification was signed more than 10 minutes before it arrived. ClickFunnels signs each retry again, so the next one is accepted.
- Partial refund, amount unknown: the sale still counts. ClickFunnels doesn't send the amount of a partial refund. The sale is marked partly refunded and keeps the full amount of that order.
- Ignored: subscription period ended. A subscription's paid period ended; it isn't a new sale.
- Counted, not matched to a play. The buyer's email doesn't match a viewer of the last 7 days.