---
title: "Pagar.me Integration"
description: "Learn how to connect OneClick Tracking to Pagar.me via webhook to track your store's paid orders in your Meta Ads campaigns."
---

> Learn how to set up OneClick Tracking on Pagar.me.

**OneClick Tracking** is a feature for Meta Ads advertisers who take their store's or website's payments through Pagar.me. It provides immediate, accurate conversion tracking.

This solution **corrects wrong attributions made by Meta**, delivering **real data based on UTMs** and enabling safer scaling decisions.

**With OneClick Tracking you see the volume of real conversions per period right in your Ads Manager, making for a quick, clear audit without complicated dashboards that need to be kept up to date.**

Using Pagar.me's order webhook, OneClick takes into account the UTMs your website writes into the order as well as Meta's data, without duplicating conversions.

:::caution[The UTMs must be written into the order]
Pagar.me is a payment gateway: it never sees the page your customer landed on. So **your website must write the UTMs into the order's `metadata` field** when it creates the order through the Pagar.me API (step 8). Without that, the sale reaches OneClick but cannot be attributed to an ad.
:::

---

:::tip[You can connect several platforms at the same time]
OneClick Tracking lets you connect **more than one platform to the same ad account** at the same time (for example, Hotmart and Eduzz together). Each platform has its own integration — with its own Webhook link or access credential — and they coexist without competing with each other; just repeat the **"New Integration"** steps for each one you want to connect.

Each sale is attributed to the right campaign by its **UTM**, not by the platform. So if one campaign sells through one platform and other campaigns sell through another, each conversion is automatically linked to the campaign it came from, regardless of which platform generated the sale. The recommended setup is **each campaign serving a single platform** — avoid having the same campaign sell on two platforms at once.
:::

## How to Plug OneClick Tracking into Pagar.me

1. Log in to your OneClick Ads account.
2. Go to the "OneClick Tracking" tab, available in the left sidebar of [OneClick Ads](https://app.oneclickads.com.br/oneclick-tracking).

   ![The OneClick Tracking tab in the OneClick Ads sidebar, with the New Integration card](../../../../../public/oneclick-tracking/common/image-1.png)

3. Click "New Integration".

4. Select the "E-commerce" product type and click Continue.

5. Select the "Pagar.me" platform and click Continue.

6. Copy the Webhook URL generated by OneClick and register it in Pagar.me by following the steps below:
   a. Each ad account will have a unique link generated automatically.
   b. This link is what connects your account to Pagar.me and tracks conversions by UTM.

   6.1. Open the Pagar.me **Dashboard** and go to **Configurações → Webhooks** (Settings → Webhooks).

   6.2. Create a new webhook and, in the **URL** field, paste the tracking URL provided by OneClick.

   6.3. In the events, check **`order.paid`** (order paid). This is the event that generates the conversion.

   6.4. Save the webhook.

   :::note[The other events can stay checked]
   OneClick Tracking records **paid orders only**. Events such as `order.canceled`, `order.payment_failed`, `charge.paid` or `invoice.paid` are received without creating a new conversion or duplicating sales.
   :::

7. Copy the UTM Script generated in OneClick Tracking.

   ![The UTM parameters step of OneClick Tracking, with the parameter to copy](../../../../../public/oneclick-tracking/common/image-2.png)

   7.1. Paste it into the "URL parameters" field in ALL of your ads in Ads Manager, as shown below:

   ![The URL parameters field of an ad in Meta Ads Manager](../../../../../public/oneclick-tracking/common/image-3.png)

8. Write the UTMs into the Pagar.me order:
   a. Add the **UTM Pass-Through Script** to all your sales pages, so the UTMs are carried to the checkout page. You can install it via Google Tag Manager or, preferably, directly in your site's header.
   b. At checkout, when creating the order through the Pagar.me API, send the URL's UTMs in the order's `metadata` object, with these names: `utm_source`, `utm_medium`, `utm_campaign`, `utm_content` and `utm_term` (the `src` and `sck` parameters are read too). For example: `"metadata": { "utm_source": "facebook", "utm_campaign": "120210000000000", "utm_content": "120210000000001" }`.
   c. If your checkout runs on a platform that uses Pagar.me underneath, check whether it has its own OneClick Tracking integration: that is the simpler path.

9. Set the Attribution Mode.
   - [Watch this video](https://www.youtube.com/watch?v=JgWkvv4ZNLY) to understand each model.
   - Click Continue.

   ![The Attribution Mode step of OneClick Tracking](../../../../../public/oneclick-tracking/common/image-4.png)

10. Set the Naming Convention that your campaigns, ad sets and ads will receive in your Ads Manager and click next.

:::caution[Campaign renaming depends on processed conversions]
The naming set here **will only be applied to the campaign name in Ads Manager once there is at least 1 processed conversion**. Receiving raw webhook data from the integrated platform is not enough — the system must have structured the conversion and attributed it to a campaign. If the webhook is arriving but the campaign name hasn't changed yet, wait for the first conversion to be recorded.
:::

![The Campaign Naming step of OneClick Tracking](../../../../../public/oneclick-tracking/common/image-5.png)
![Analysis periods and the Naming Convention preview](../../../../../public/oneclick-tracking/common/image-6.png)

---

## Done!

Wait at least 24 hours for the setup to take effect, and all your campaigns (those that receive conversions) will start recording conversions right inside Ads Manager.

![Campaigns with the OneClick Tracking prefix in Ads Manager](../../../../../public/oneclick-tracking/common/image-7.png)

---

## Important Notes

- OneClick Tracking records the **order total** (shipping included), in the order's currency (Brazilian Real).
- Each order is recorded **once**, by its Pagar.me order id, even if the webhook is resent.
- Subscriptions (invoices and renewals) are not recorded by this integration.
- Only campaigns created after the setup will have access to the "Maximum Period" data. This **does not affect** OneClick Ads optimization on older campaigns in any way.
- Keep at least one ad identifier (`ad.id`) in the UTM parameters — it is what lets OneClick Tracking match the conversion to the right campaign, ad set and ad. If the order does not carry the UTMs in `metadata`, the sale cannot be attributed.
