Connect Hotmart

Updated Oct 25, 2026 · 3 min read · Pro, Business and Agency plans

This article shows you how to send Hotmart purchases, order bumps, renewals, 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

You register PlayerMagick's private address as a webhook in Hotmart. Hotmart sends each event with your account's token (the "hottok"), and PlayerMagick checks it, so nobody else can send you fake sales.

PlayerMagick adds xcod=… to your buttons' Hotmart checkout links. Hotmart sends it back with the purchase, so the match is exact. Order bumps are matched through the purchase they were added to. Hotmart doesn't say which purchase a one-click upsell belongs to, so upsells are matched by the buyer's email when that person watched your video.

Before you start

  • You need a Hotmart producer account with at least one product.
  • Revenue is kept in the purchase's currency (BRL, USD, EUR…), never converted.

Step 1: Connect Hotmart in PlayerMagick

  1. Go to Settings → Sales platforms and click Connect a platform.
  2. Next to Hotmart, click Connect, then Connect again.
  3. The setup page shows your receiver address. Copy it now: PlayerMagick shows it only once.

Step 2: Register the webhook in Hotmart

  1. In Hotmart, open Tools → Show all → Webhook (API and notifications) and click Register Webhook.
  2. Enter a name, choose version 2.0.0, and choose all products (or the products your videos sell).
  3. Select the purchase events (approved, refunded, chargeback) and subscription cancellation.
  4. Paste the receiver address as the URL and save.
  5. Open the Authentication tab and copy the token (hottok).

Step 3: Save the token in PlayerMagick

  1. On the setup page, paste it into Hotmart token (hottok) and click Save.

Step 4: Check it works

  • Click Send a test sale in PlayerMagick. The result says what a real sale would be matched to. Test sales never count.
  • Don't use Hotmart's own test send: it carries no test mark, so PlayerMagick would count it like a real sale.
  • Hotmart's webhook page has a history of everything it sent, with PlayerMagick's answer.

Point the player's buttons at your Hotmart checkout links (https://pay.hotmart.com/…). PlayerMagick adds xcod=… when the viewer clicks.

If your link already uses xcod (for your own tracking), PlayerMagick leaves it alone and adds sck=… instead, which Hotmart also sends back. If both are taken, those sales are matched by the buyer's email.

Troubleshooting

  • Refused: the signature didn't match the saved secret. The token in PlayerMagick differs from the one on the webhook's Authentication tab. Copy it again.
  • Ignored: event PURCHASE_COMPLETE (or another event). Hotmart sends several events per purchase, such as the end of the guarantee period, unpaid boletos and refund requests. They don't change your sales, so PlayerMagick only logs them. The sale counts on the approved purchase; a refund or chargeback takes it out.
  • A renewal doesn't show as a sale. Subscription renewals appear as renewals under Settings → Sales platforms, not as new sales of your video.
  • Hotmart turned the webhook off. Hotmart stops a webhook that keeps failing. Check the address and the token, then turn it on again.

Was this article helpful?