November 20, 2013
Updated March 1, 2020
The Post Back URL configuration allows you to select posting back an order type and/or order actions. The order type selection will allow the Platform to perform a server side posting of your pixels directly to your third party affiliate tracking software such as Linktrust, HasOffers, HitPath, DirectTrack, Cake Marketing, or your own in house solution. If post back URL is enabled, there will be no need to host a pixel on your confirmation page since pixel firing will automatically be done by the Platform. The Post Back URL will allow you to configure what gets posted to your affiliate tracking system from the additional fields that are populated.
To add a new Post Back URL profile, you will need to navigate to Settings > Post Backs, and select 'Create' from the Actions drop-down menu. From there, a new page will populate where you can build out your Post Back URL and add any necessary tokens. You will need to just need to click "VIEW TOKENS / BUILD URL" next to the 'tokens' field as shown below, and you will be navigated to the Post Back builder.
Post Back Builder:
This is where you will build out your Post Back URL and add any additional tokens. Within the "Base URL" field, you will need to just enter in the URL, and then select any of the check boxes to select the tokens that you would like to add to the URL. Click on "SAVE", and the URL will then be automatically populated within the add Post Back URL section, where you can then complete your setup.
Name: Create a name for your Post Back URL profile.
HTTP Method: GET/POST/PUT. This will define the HTTP request method that is used when the post back is sent.
Type: Order or Prospect
Tokens: Where your Post Back URL is built, add or edit the URL or any tokens here
URL: The Post Back URL that is used to post to your affiliate tracking system. Also, multiple tokens can be passed dynamically through this Post Back URL.
Trigger Type: Order Type or Order Action. If "Order Action" is selected, the view will change and you will have the option to select any of the actions: Void, Refund, Cancel, Hold, Reset Recurring, Chargeback, Alert, Representment, Tracking Updated, Card Updated, Recurring Date Change and Fraud On.
Order Type: In this field, select whether you will post back just initial or subscription, or both initial and subscription orders.
Order Status: In this field, select whether you will post back just approved or declined, or both approved and declined orders.
Payments: In this field, select whether you will post back just non-test payments or test payments, or both non-test payments and test payments.
Global: When checked, this Post Back URL will automatically be associated with all campaigns, now and moving forward.
Campaigns: Attach this Post Back URL to one or more campaigns. When the campaigns are selected here, there is no need to go into each additional campaign to add them.
List of Available Postback Tokens:
Name | Discription |
{affid} | Affiliate AFFID |
{affiliate} | Affiliate |
{afid} | Affiliate AFID |
{aid} | Affiliate AID |
{ancestor_id} | First order in the subscription chain |
{authorization_id} | Authorization Id Of Order |
{billing_address_2} | Customer billing address 2 |
{billing_address} | Billing Street Address Of Order |
{billing_city} | Billing City Of Order |
{billing_country} | Billing Country Of Order |
{billing_state_desc} | Billing State Description Of Order |
{billing_state_id} | Billing State ID Of Order |
{billing_zip} | Billing Zip Of Order |
{c1} | SUB-Affiliate C1 |
{c2} | SUB-Affiliate C2 |
{c3} | SUB-Affiliate C3 |
{campaign_desc} | The Campaign Description |
{campaign_id} | Campaign Id Of Order |
{campaign_name} | The Campaign Name |
{cb_service_outcome} | Chargeback Service Outcome |
{cb_service_source} | Chargeback Service Source |
{cb_service_type} | Chargeback Service Type |
{click_id} | Click ID (Used by your third party affiliate tracking system to identify a unique click) |
{currency_code} | Currency code, eg: USD, EUR, GBP, CAD, AUD, ZAR, JPY |
{customer_id} | Customers Id |
{decline_reason} | If order_status = 0, this value will be the decline reason from the payment gateway. |
{decline_salvage_discount} | Discount applied as a result of subscription management decline salvage settings. |
{digital_delivery_password} | If using supported membership providers, the value of the password generated |
{digital_delivery_username} | If using supported membership providers, the value of the username generated |
{email} | Email Address On Order |
{first_name} | First Name On Order |
{gateway_id} | Gateway Id On Order |
{ip_address} | Ip Address On Order |
{ischargeback} | The Chargeback Flag in Orders |
{is_fraud} | This flag indicates whether this order was marked automatically as fraud by a fraud provider mid-way in the transaction. |
{is_gift} | 1 if it is a gift order, 0 if it is not a gift order |
{is_recurring} | Does Order Have Active Recurring |
{is_shippable} | Is the order shippable |
{is_test_cc} | This flag indicates whether this is a test credit card or not |
{last_name} | Last Name Of Order |
{new_recurring_date} | New recurring date |
{non_taxable_amount} | Non Taxable Amount |
{opt} | SUB-Affiliate OPT |
{order_date_time} | DateTime of Order mm/dd/yyyy hh:mm:ss. Where hours are in military time 00-24 |
{order_date} | Date of Order mm/dd/yyyy |
{order_id} | New Order Id Created |
{order_status} | 1 For Approvals, 0 For Declines |
{order_total} | Final Order Charged |
{parent_order_id} | Parent Of Order |
{payment_method} | Payment Method Of Order: VISA, DISCOVER, MASTERCARD, AMERICAN EXPRESS, OFFLINE, CHECK or UNKNOWN |
{phone} | Phone Number Of Order |
{post_back_action} | Action Identifier |
{product_id_csv} | A CSV of all the product ids taken on order |
{product_names_csv} | A CSV of all the product names taken on order |
{product_prices_csv} | A CSV of all the product prices taken on order |
{product_qtys_csv} | A CSV of all the product quantities taken on order |
{product_skus_csv} | A CSV of all the product skus taken on order |
{rebill_depth} | Billing Depth Of Order |
{rebill_discount} | Rebill discount applied to order |
{recurring_date} | Recurring Date Of Order |
{retry_attempt} | Decline salvage retry attempt |
{sales_tax_percent} | Sales Tax Percent |
{shipping_address_2} | Customer shipping address 2 |
{shipping_address} | Shipping Street Address Of Order |
{shipping_city} | Shipping City Of Order |
{shipping_country} | Shipping Country Of Order |
{shipping_group_name} | Shipping Method Group Name |
{shipping_id} | Shipping Method Id |
{shipping_method} | Full string value of the shipping method the consumer selected |
{shipping_state_desc} | Shipping State Description Of Order |
{shipping_state_id} | Shipping State ID Of Order |
{shipping_total} | Shipping Amount |
{shipping_zip} | Shipping Zip Of Order |
{sid} | Sub-Affiliate SID |
{subscription_active_csv} | Recurring active flag |
{subscription_id_csv} | A CSV of all the subscription ids |
{sub_affiliate} | Sub Affiliate. If using affiliate AFID, SID. If using affiliate AFFID, a CSV will be passed with the values of any non empty elements for C1, C2, and C3. If using affiliate AID, OPT. |
{taxable_amount} | Taxable Amount |
{tax_factor} | Tax Factor |
{total_no_shipping} | Order total minus shipping |
{trackingnumber} | Tracking number |
{transaction_id} | Transaction Id Of Order |
{utm_campaign} | UTM Campaign |
{utm_content} | UTM Content |
{utm_device_category} | UTM Device Category |
{utm_medium} | UTM Medium |
{utm_source} | UTM Source |
{utm_term} | UTM Term |
{void_refund_amount} | Order refunded or voided amount |
{was_reprocessed} | This flag indicates that the order was salvaged from a decline. 0 Means no, 1 means was reprocessed through decline salvage on orders, 2 means the recurring billing salvaged after retry |