Marketplace sources
The six order sources and why setting them correctly matters.
Every order carries a source recording where the sale came from.
| Source | Used for |
|---|---|
paddle |
A normal purchase through Paddle checkout. Set automatically by the webhook. |
appsumo |
Redeemed AppSumo code. |
dealify |
Redeemed Dealify code. |
dealmirror |
Redeemed DealMirror code. |
pitchground |
Redeemed PitchGround code. |
manual |
An order you created by hand — a wire transfer, a partnership, a reconciled lost webhook. |
Why it matters#
- Revenue by source in analytics is built on it. It is how you find out whether a marketplace deal actually paid.
- Stacking is scoped to it. Codes only stack with other codes from the same marketplace.
- Support context. A lifetime-deal buyer and a monthly subscriber have very different expectations, and the source tells you which you are talking to before you reply.
Setting it#
Paddle purchases and code redemptions both set it automatically. The only time you choose is when creating an order by hand — and manual is almost always the honest answer. Marking a hand-made order as paddle puts revenue in your reports that Paddle never collected.
Adding a marketplace#
The source list is a PHP backed enum. Adding a sixth marketplace means adding a case to the enum and its label to the translation files. Existing orders are unaffected.