> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tagada.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Binom

> Server-side conversion postback for Binom (self-hosted tracker), fired automatically on every paid order

# Binom

[Binom](https://binom.org) is a self-hosted click-id-based ad attribution tracker. Because Binom runs on your own server, the "tracking domain" you give TagadaPay is the domain of your Binom installation.

***

## Setup

<Steps>
  <Step title="Find your Binom installation domain">
    Binom is self-hosted, so the tracking domain is whatever URL you use to access your Binom panel (e.g. `track.yourdomain.com`). It's the same hostname your campaigns redirect through — you'll see it in Binom under **Sites & Domains**.
  </Step>

  <Step title="Enable Binom in TagadaPay">
    Dashboard → **Settings → Integrations → Binom → Connect**. Paste your Binom hostname (no `https://`), save.

    No API key required — Binom's `/click.php` endpoint authenticates entirely via the click\_id.
  </Step>

  <Step title="Forward the Binom clickid through your offer URL">
    Binom's clickid token is `{clickid}`. Your campaign's offer URL should be:

    ```
    https://yourstore.com/checkout?clickid={clickid}
    ```

    TagadaPay also reads `click_id` and the `_binom` cookie as fallbacks.
  </Step>

  <Step title="Test with a real conversion">
    Place a test order. The conversion should appear in Binom's **Reports** within \~60s.
  </Step>
</Steps>

***

## What TagadaPay Fires

Per [Binom's official postback URL spec](https://docs.binom.org/postback-url.php):

```
https://{trackingDomain}/click.php?cnv_id={clickId}&payout={payout}&cnv_status={conversionType}&cnv_currency={currency}
```

**Parameter mapping:**

| Binom param    | Source                                               | Notes                                                                                                                                |
| -------------- | ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| `cnv_id`       | Click\_id captured on lander                         | Required. Binom's S2S conversion-id parameter.                                                                                       |
| `payout`       | Order's paid amount in major units                   | Optional override available.                                                                                                         |
| `cnv_status`   | Conversion type from integration form (default: `1`) | Binom uses numeric statuses: `1` = approved, `2` = pending, `3` = trash, etc. Customise per offer if you need a non-approved status. |
| `cnv_currency` | Order's currency                                     | Forwarded so Binom can correctly report multi-currency revenue.                                                                      |

***

## How TagadaPay Identifies the Click

In priority order:

1. URL parameter `clickid` (Binom's canonical name)
2. URL parameter `click_id` (fallback)
3. Cookie `_binom`
4. Cookie `binom`

***

## Optional Settings

* **Conversion type** — sent as `cnv_status`. Defaults to `1` (approved). Set to `2` if you want conversions to land in Binom as **pending** for manual review.
* **Fixed payout** — overrides the order amount if set. Useful for fixed-CPA reporting.

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="Binom shows 0 conversions but TagadaPay logs say the postback fired">
    1. Check the **Sites & Domains** allowlist in Binom — postbacks from unknown domains can be silently rejected.
    2. Confirm the tracking domain in TagadaPay matches the exact hostname Binom is reachable on (no `www.` mismatch).
    3. Open the Binom server logs — the request will show with the `cnv_id` value. Compare to the click\_id captured in TagadaPay's customer metadata.
  </Accordion>

  <Accordion title="Conversion lands as &#x22;Trash&#x22; instead of &#x22;Approved&#x22;">
    The `cnv_status` parameter is set to `3` (trash) somewhere — check the **Conversion type** field in the TagadaPay integration form. Default is `1`.
  </Accordion>
</AccordionGroup>

***

## References

* [Binom: Postback URL setup](https://docs.binom.org/postback-url.php)
* [Tracking & Attribution overview](/developer-tools/tracking/overview)