⚠️ This setting is only available for workspace commissions from advertisers, because partner commissions reflect those values.
Recurrence limits how many transactions one commission can create for the same customer journey. It protects you when an advertiser sends the same conversion more than once, whether by mistake or because they cannot deduplicate on their side.
The options
- Once: the commission creates one transaction and then stops. This is the default for new commissions.
- Limited: you set the maximum yourself.
- Unlimited: the commission is applied every time a matching conversion arrives.
Existing commissions keep the setting they already have, so older ones may still be unlimited. Check them if you see repeated transactions.
Allowing more than one transaction
⚠️ When multiple conversions are enabled for a single commission, update postbacks will not work unless an External ID or Conversion ID is provided, as the system cannot determine which conversion should be updated.
With Once, there is only ever one conversion to update, so an update postback can find it on its own. With Limited or Unlimited there can be several, and PalDock has no way to tell which one the advertiser means.
- Agree with the advertiser that every request carries an external ID, unique per order, before you move away from Once.
- A conversion ID works too, when the advertiser stores the one PalDock returned.
- Without either, updates are ignored and results stay Pending, even though new conversions keep being created normally.
What counts towards the limit
PalDock counts the transactions already created by this one commission, and only those that match all of the following:
- They sit on a conversion that belongs to the same original click or lead, anywhere in that chain.
- The conversion has the same type, so sales and prospects are counted separately.
- The conversion has the same advertiser.
- The conversion has the same external ID. Conversions that arrived without an external ID are counted together as one group.
Transactions on invalid or rejected conversions are not counted.
When the limit applies
- The limit is checked on conversions that follow an original click or lead. The original click or lead itself is never limited, because there is nothing before it to repeat.
- When the limit is reached, the commission is no longer offered for that conversion. If another commission matches, that one is used instead. Nothing is created if none does.
What this means in practice
- The limit is per commission, not per offer. Two commissions on the same offer each keep their own count, so one order can still create one prospect transaction and one sale transaction.
- Because the external ID is part of the match, an advertiser who sends a different external ID for each order can create several transactions from one click even with Once. That is usually what you want for repeat purchases.
- An advertiser who sends no external ID at all gets one transaction per commission with Once, because everything falls into the same group.
- An advertiser who sends no external ID at all gets one transaction per commission with Once, because everything falls into the same group. Raising the limit for such an advertiser is rarely useful, because their updates cannot be matched either.
Recurrence or deduplication
Both prevent duplicate transactions, but they act at different points.
- Recurrence limits how many transactions a commission may create. It works even when the advertiser sends no external ID.
- Deduplication based on the advertiser’s ID refuses the duplicate conversion itself, before any commission runs.
Use both. Deduplication keeps your conversion data clean, recurrence is the safety net when the external ID is missing.
