← All articles
5 min read

Postback URL Parameters: A Cheat Sheet

Every postback URL is built from the same handful of macros. Here's a reference cheat sheet for the parameters you'll actually use across Impact, PartnerStack, ShareASale, and others.

Every affiliate network uses slightly different macro syntax, but the underlying parameters are the same. This cheat sheet maps the common ones across networks so you don't have to keep three docs open.

Identity & idempotency

  • Click ID / SubID: Impact {SubId1}, PartnerStack {custom_key}, ShareASale {sscid}.
  • Order / action ID: Impact {OID}, PartnerStack {customer_key}, ShareASale {transactionid}.
  • Partner / publisher ID: Impact {MediaPartnerId}, PartnerStack {partner_key}.

Money

  • Payout (your commission): {Payout} / {reward_amount} / {commission}.
  • Sale amount: {IntendedAmount} / {order_total} / {amount}.
  • Currency: {Currency} / {reward_currency}.

Event metadata

  • Status: APPROVED, PENDING, REVERSED. Always check this in your handler.
  • Event time: server time of the action; forward as event_time to CAPI/Google.
  • Event type: sale, lead, install — useful when one tracker handles multiple events.

A reusable template

https://yourdomain.com/p
  ?click_id={SUBID}
  &payout={PAYOUT}
  &amount={AMOUNT}
  &currency={CURRENCY}
  &order_id={ORDER}
  &status={STATUS}
  &event_time={TIMESTAMP}

Rules of thumb

  • Always carry an order/action ID. Without it you can't dedupe.
  • Always carry status. Forwarding REVERSED to Meta as Purchase is bad data.
  • Always carry the click ID, not the customer ID — they are not the same thing.