External Final Page

The External Final Page feature lets partners replace the internal PalDock FinalPage with their own, enabling a customized user experience or integration into a comparison page.

This is useful if you want to:

• Keep full control over the user experience and branding.
• Display additional offers or comparisons alongside PalDock results.
• Integrate PalDock lead responses directly into your own website.

The feature works with both API and iFrame submissions. When enabled, PalDock redirects the user to your external URL and provides a Detailed Response with all cascade processing results. This data is delivered either as part of the API response or as encoded query parameters in the iFrame redirect.

Admins can decide whether to enable this option for API only, iFrame only, or both. You can also allow or exclude specific affiliates from using the feature.

How It Works

When enabled, PalDock redirects the user to the external URL after cascade processing and includes a Detailed Response with the lead’s full processing breakdown.

1. Provide External Redirect Parameters

To activate the feature, you must include the following parameters in the API payload or form code:

• external_redirect_url → The URL of your external page (e.g., https://yourdomain.com/result).

2. Lead Processing

PalDock processes the lead across the cascade channels (offers, non-exclusive, choice, auctions). For each item, PalDock records:

• Product ID and Product Name (from the PalDock feed).
• Channel ID and Channel Name and Type.
• Status (accepted, rejected, pending).
• Redirect URL returned by the channel.
• Whether it was chosen (for choice channels).

3. Response Delivery

The results of processing can be returned in two ways:

• API – Detailed Response is included in the JSON response under the items array.
• iFrame – Parameters are flattened and passed as encoded query parameters in the redirect URL.

In both cases, you receive:

• Overall lead status.
• Number of items handled vs. total items.
• List of successful items.
• Full breakdown of cascade results.

4. Display on Your Final Page

Your external page must be able to:

• Parse the query parameters (for iFrame) or the JSON response (for API).
• Match the received product/channel IDs with your own feed or with PalDock feed (easier).
• Render the results in your own design (e.g., comparison table, personalized offers).

The iFrame redirect occurs only after all items in the cascade are handled.

Parameters

PalDock provides a consistent set of parameters in both API responses and iFrame/query responses.

General Parameters

• id – PalDock internal ID of the lead.
• external_id – External lead ID (if provided in request).
• status – Overall lead status (approved, rejected, pending).
• redirectUrl – Final redirect URL.
• items_handled – Number of items already processed.
• items_total – Total number of items in cascade.
• successful_items – List of successfully accepted items (comma-separated in query).
• feed_id – ID of the data feed from which data should be taken.
• feed_name – Name of the data feed.
• feed_url – URL of the feed with data.

Item Parameters

Each product/channel entry in the cascade contains the following fields:

• product_id – Product ID (from PalDock feed or partner mapping).
• product_name – Product name (from feed or mapping).
• channel_id – Internal PalDock ID of the channel.
• channel_name – Name of the channel.
• status – Status of processing for this item (accepted, rejected, pending).
• type – Type of channel (offer, pingtree_nonex, pingtree_choice, auction).
• redirect_url – Redirect URL returned by the channel.
• chosen – Indicates whether the channel was selected on a Choice page (only for choice channel types).

API vs iFrame Differences

• API response – Parameters are nested in the items array.
• iFrame/query response – Parameters are flattened (not nested), but names keep the nesting convention (e.g., items[0].product_id → items_0_product_id). All URLs are encoded.

Configuration

To enable the External Final Page and Detailed Response features, the Admin must configure them in the Offer settings.

Step 1: Enable External Final Page

1. Go to the Offer settings.
2. Define whether the feature should be available for API only, iFrame only or both.

Step 2: Provide External Redirect Parameters

Add the following parameters either to the API payload or to the form code:

• external_redirect_url – Defines the external URL where the user should be redirected.

Step 3: Configure Affiliate Access

You can decide whether this feature is enabled for all affiliates or restricted to specific affiliates.

Connecting Product Data

The External Final Page feature provides detailed identifiers for each product and channel in the API response or query string. To display the correct product information on your external page, you need to connect this data with your product catalog.

You can do this in two ways:

Option 1: Use the PalDock Feed (Recommended)

If your comparison website already uses the PalDock product feed, the mapping is straightforward.

• Each row in the PalDock feed has a unique product_id.
• The API response includes the same product_id (and product_name), so you can directly align the two.
• This ensures automatic updates and minimal maintenance.

Option 2: Map to Your Own Product Feed

If you do not use the PalDock feed (e.g., you maintain your own CSV or database), you must manually map PalDock identifiers to your internal IDs.

• Use the product_id and product_name from the API response.
• Create a mapping table that links PalDock’s product_id with your own product identifiers.
• This requires more setup and ongoing maintenance.

Examples

API response

You can track the status of a lead through several methods. Full details are available on the API Integration page.

Detailed Response

{  "id": "1234",  "external_id": "4321",  "status": "pending",  "redirectUrl": "https://google.com",  "items_handled": "2",  "items_total": "3",  "successful_items": ["1", "2"]  "feed_id": 1,  "feed_name": saas,  "feed_url": "https://paldock.com/tenant/feed/saas/",  "items": [    {      "product_id": 1,      "product_name": "P123",      "channel_id": 1,      "channel_id": "CH123",      "status": "accepted",      "type": "offer",      "redirect_url": "https://google.com"    },    {      "product_id": 2,      "product_name": "P223",      "channel_id": 2,      "channel_id": "CH223",      "status": "accepted",      "type": "pingtree_nonex",      "redirect_url": "https://google.com"    },    {      "product_id": 3,      "product_name": "P323",      "channel_id": 3,      "channel_id": "CH323",      "status": "pending",      "type": "pingtree_choice",      "chosen": false    }  ]}

Form response

?id=1234&external_id=4321&status=pending&redirectUrl=https%3A%2F%2Fgoogle.com&items_handled=3&items_total=3&successful_items=1,2&feed_id=1&feed_name=saas&feed_url=https%3A%2F%2Fpaldock.com%2Ftenant%2Ffeed%2Fsaas%2F&items_1_product_id=1&items_1_product_name=P123&items_1_channel_id=CH123&items_1_status=accepted&items_1_type=offer&items_1_redirect_url=https%3A%2F%2Fgoogle.com&items_2_product_id=2&items_2_product_name=P223&items_2_channel_id=CH223&items_2_status=accepted&items_2_type=pingtree_nonex&items_2_redirect_url=https%3A%2F%2Fgoogle.com&items_3_product_id=3&items_3_product_name=P323&items_3_channel_id=CH323&items_3_status=pending&items_3_type=pingtree_choice&items_3_chosen=false