Skip to main content
Skip table of contents

Postback Replacement Tokens

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

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 Understanding 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 Understanding Action Type vs. Event Name in KMP

{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 Understanding Attribution Type 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.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.