Postback Replacement Tokens | Katalys Knowledge Base

The following replacement tokens can be placed into the URL or Body fields when creating or managing a Webhook Postback.

Examples:

Sending your payout amount to your server:
https://your-server-host.com/?aff_id={aff_id}&offer_id={offer_id}&payout={payout}
Reporting a unique value you stored in “Sub 1” with amount that value made:
https://your-server-host.com/?unique_value={aff_sub1}&payment={payout}

Token	Format	Description
`{aff_id}`	Integer	Partner’s Traffic Source ID attributed to this conversion
`{offer_id}`	Integer	Advertiser’s Program ID attributed to this conversion
`{transaction_id}`	Hexadecimal string	Transaction ID (aka click ID) generated by Katalys, associated with this conversion. Transaction IDs are not always unique, but should uniquely identify a user action seen or forwarded by a Katalys partner.
`{order_time}`	Date/Time string	The time the order was placed by the user. String is formatted per ISO 8601, such as `2025-10-26T10:30:00.000-04:00`.
`{click_time}`	Date/Time String	The time the user clicked. String is formatted per ISO 8601, such as `2025-10-26T10:30:00.000-04:00`. Not all conversions have a click, such as coupon conversions. If there is no click, this string will be empty.
`{conversion_status}`	Number	The status of the conversion. Only conversions marked in the “Approved” status will be paid. See Conversion Statuses for details to map the number to their meaning.
`{seq}`	String	Case-sensitive GUID uniquely identifying this conversion or order within Katalys systems. Example: `000A8kwB_41x762e7D4_SH0p`
`{action_type}`	String	See Action Type vs. Event Name
`{postback_operation}`	String	The operation being processed when sending this postback notification. Value can be `create`, `update`, or `delete`.
`{aff_sub1}`	User-entered string, max 250 characters	partner only Partner-defined string, passed into the `aff_sub`, `aff_sub1`, or `sub1` parameter within a Katalys Tracking Link.
`{aff_sub2}`	User-entered string, max 250 characters	partner only Partner-defined string, passed into the `aff_sub2` or `sub2` parameter within a Katalys Tracking Link.
`{aff_sub3}`	User-entered string, max 250 characters	partner only Partner-defined string, passed into the `aff_sub2` or `sub2` parameter within a Katalys Tracking Link.
`{aff_sub4}`	User-entered string, max 250 characters	partner only Partner-defined string, passed into the `aff_sub2` or `sub2` parameter within a Katalys Tracking Link.
`{aff_sub5}`	User-entered string, max 250 characters	partner only Partner-defined string, passed into the `aff_sub2` or `sub2` parameter within a Katalys Tracking Link.
`{aff_source}`	User-entered string, max 250 characters	partner only Partner-defined string, passed into the `aff_sub2` or `sub2` parameter within a Katalys Tracking Link.
`{payout}`	Number	partner only The payout owed to the partner for this conversion. For any payable conversion, this value will be greater than `0`. For “Last Click” conversions, this will be the value `0`. For “Partial” conversions, this will be an empty string signifying `null` value. See Attribution Types for details on Last Click and Partial conversions.
`{cost}`	Number	Advertiser only The amount owed to Katalys for this conversion.
`{order_id}`	String	Advertiser only The CRM-provided string that uniquely identifies the order within the Advertiser’s system.
`{order_value}`	Number	Advertiser only The value of the order for the purpose of calculating CPS payouts. This is the reported `sale_amount` minus any reported tax or shipping fees, less any discounts.
`{vendor_status}`	String	Advertiser only The CRM-provided value of the fulfillment status for the order. Examples are `rejected`, `shipped`, or `paid`.