Connect Hotmart to Nevian

Time needed: about 5 minutesLast updated:

Send every Hotmart purchase to Nevian with one webhook, so each sale, refund and chargeback shows up next to the ad that brought the buyer.

What you need

  • A Hotmart producer account that can open Ferramentas (Tools) at app.hotmart.com.
  • A Nevian workspace with an active plan (Beginner, Pro or Enterprise), where you are the owner, an admin or a member. Viewers can't connect integrations.
  • The two tabs side by side: Nevian on Integrations and Hotmart.

Steps

  1. In Nevian, open Integrations, click Add integration (Connect provider when nothing is connected yet) and pick Hotmart. In the Connect Hotmart window, have the platform open in another tab, then click Next to get your private URL.

    The Connect Hotmart window in Nevian, with the Next button highlighted.

  2. Nevian creates your private Webhook URL. Click the copy button next to it and leave this window open: the Hottok field below is where you paste Hotmart's key in step 8.

    The Webhook URL in the Connect Hotmart window, with its copy button highlighted and the empty Hottok field below.

  3. In Hotmart, click Ferramentas (Tools) in the side menu, then Ver todas (See all), and open Webhook (API e notificações) (Webhook, API and notifications). You can also type "Webhook" in the search bar of that page.

    Hotmart's Ferramentas page, with the Webhook (API e notificações) tool highlighted.

  4. On the Minhas configurações (My settings) tab, click + Cadastrar Webhook (Register webhook).

    The Webhook page in Hotmart on the Minhas configurações tab, with the + Cadastrar Webhook button highlighted.

  5. Name it Nevian, choose all your products (or one), paste the URL in URL para envio de dados (URL to send data) and keep the version on 2.0.0.

    Hotmart's new webhook form with the name Nevian, all products, the pasted Nevian URL highlighted and version 2.0.0.

  6. Under Eventos para enviar (Events to send), tick the nine purchase events: Compra aprovada, Compra completa, Aguardando pagamento, Compra atrasada, Pedido de reembolso, Compra cancelada, Compra expirada, Compra reembolsada and Chargeback. Click Salvar (Save).

    The nine purchase events ticked, the cart and subscription events left blank, and the Salvar button highlighted.

  7. Open the Autenticação (Authentication) tab and copy the code in Hottok.

    The Autenticação tab of Hotmart's Webhook page, with the copy button of the Hottok highlighted.

  8. Back in Nevian, paste it in the Hottok field and click Next. Keep the test step open until the first event arrives, then click Done. Nevian saves it and checks it on every call from now on.

    The Connect Hotmart window with the Hottok pasted and the Next button highlighted.

  9. In Hotmart, go back to Minhas configurações, click the list icon at the right of the Nevian configuration and send a test.

    The Nevian configuration in Hotmart's list, with the list icon at the right highlighted.

  10. In Nevian, the Hotmart card in Integrations turns Connected a few seconds after the test arrives.

    The Hotmart card in Nevian's Integrations list showing Connected.

Check that it works

  • The Hotmart card in Integrations says Connected and shows the time of the last event.
  • Logs › Webhooks lists the test exactly as Hotmart sent it. Nevian marks Hotmart's sample purchase as a test: it never counts in revenue or conversions.
  • Hotmart keeps its own record on the Histórico (History) tab of the Webhook page: 200 means Nevian received the call.
  • For real sales, keep the Nevian tracking script on the pages with your buy buttons. It adds the click ID to every link to pay.hotmart.com (as sck) and keeps any src you already use. Hotmart sends it back with the purchase, so the sale lands on the right ad. Order bumps arrive as their own purchases and count as their own sales.

Problems

"Waiting for the first event" doesn't change

Hotmart hasn't sent anything that Nevian accepted yet. In Hotmart, open the configuration again and check that URL para envio de dados has the whole URL, that the version is 2.0.0 and that the purchase events are ticked. If the URL ever answered with an error, Hotmart turns the configuration off by itself: turn it back on. If you rotated the key in Nevian, the old URL stops working: copy the new one from the integration's Connection tab.

"Hotmart reached Nevian, but the call was rejected"

The call arrived, but its Hottok doesn't match the one saved in Nevian. Copy the Hottok again from the Autenticação tab, open the Hotmart card in Integrations, go to the Connection tab, click Replace, paste it and click Save. Then send the test again.

"Hottok missing" on the card

You clicked Close before pasting the Hottok. Every Hotmart call is rejected until it is saved: paste it in the Connection tab of the Hotmart card and click Save.

"no matching click" on a real sale

The test never has a click, so this is normal there. On a real sale it means the buyer reached the Hotmart checkout without the click ID: check that the Nevian tracking script is on the page with the buy button and that the button links to pay.hotmart.com.

Version 1.0.0

Nevian reads Hotmart's version 2.0.0 only. Hotmart discontinued 1.0.0: if an old configuration still uses it, create a new one with 2.0.0 for Nevian. Hotmart explains its webhook in its own help article.

Still stuck? Write to [email protected].

Images are drawings of Hotmart's and Nevian's screens, not screenshots; the real screen may look a little different.