Checkout sales

How to connect Hotmart to TraceClose

Updated October 12, 2026

Step by step

1. Create the connection in TraceClose

   In Settings › Integrations, click New connection and, under Checkout sales, choose Hotmart. Keep the tab open: the screen shows the Webhook URL (with a copy button) and the Hottok field.

2. Open Webhook in Hotmart

   Sign in to Hotmart with the producer account and open Tools › See all › Webhook (API and notifications). If you can’t find it, search for “Webhook” in the menu search.

3. Copy the Hottok

   On the Webhook screen, open the authentication tab and copy the Hottok, the code Hotmart sends with every notification. Paste it into the Hottok field in TraceClose.

4. Register the webhook

   Click Register webhook. Give it a name (e.g., “TraceClose”), paste the TraceClose Webhook URL as the delivery URL, choose all products or a specific product and check the events: Purchase approved, Purchase refunded, Chargeback and Purchase canceled. If the screen asks for a version, use the latest one (2.0.0). Save.

5. Pick the options and save

   Choose whether to keep sending Purchase to Meta (on by default; if the checkout pixel already sends the purchase, see below) and whether an unpaid checkout becomes a lead (off by default). Click Save.

6. Test it

   In Hotmart, under My settings, open the list icon next to the webhook and send the test. The notification shows up on the connection in TraceClose as the last event received.

Which URL to use

The dashboard shows the URL ready to copy, in the format https://t.traceclose.com/webhooks/sales/hotmart/<connection-id>. It’s unique to your connection: don’t use another account’s URL or another platform’s.

Abandoned carts and pending payments (optional)

To let salespeople win back buyers who didn’t pay, turn on unpaid checkout becomes a lead in the connection and, in Hotmart, also check Cart abandonment and Awaiting payment. These events create (or find) the lead with its source, with no sale and no Purchase. If the buyer pays later, the sale goes to the same lead.

What happens in TraceClose

• An approved sale becomes a sale in TraceClose, with the amount paid and the order’s currency, credited to the lead’s salesperson. The lead moves to the won stage.
• The lead is matched by the checkout link reference, then by phone, then by email. No match: the lead is created with the source the checkout stored and goes into the rotation.
• An existing lead keeps its source and salesperson: someone who came from a click-to-WhatsApp ad stays credited to that ad.
• Refunds and chargebacks cancel the sale. The same delivery resent by the platform never creates duplicates.

To match the sale to the right lead even when the buyer pays with a different email or phone, use Copy checkout link in the lead details: paste the product URL and TraceClose adds the lead reference to the platform’s tracking parameter. In Hotmart, the reference goes in the sck parameter, which Hotmart stores with the sale. If you already use sck for something else in that link, the TraceClose one takes its place.

If the Meta pixel is already installed on the platform’s checkout and sends Purchase, choose who sends the purchase: turn off Purchase sending in this connection with one click (or turn off Purchase in the checkout pixel). That way Meta gets the sale only once, and it still shows up in the dashboard and in ROAS.

Didn’t work? See…

• Nothing arrives: check that the whole URL was pasted and that the webhook is active in Hotmart. Hotmart turns the setup off on its own when the URL responds with an error several times: fix it and turn it back on.
• The connection shows an authentication error: the Hottok pasted into TraceClose doesn’t match Hotmart’s. Copy it again and save it in Edit.
• The sale arrived but didn’t reach Meta: see the sale doesn’t show up in Meta.
• Hotmart keeps the delivery history for 60 days and lets you resend: in the History tab, or in Sales › My sales, in the sale details.

Frequently asked questions