Skip to content

DataPass

Overview

This document describes how to use DataPass functionality for Full Funnel and Direct Click campaigns. DataPass enables publishers to transmit user data for form pre-population, facilitating seamless data transfer between systems and improving user experience through automated form completion.

DataPass Modes

There are two ways to pass data to us:

  1. DataPassGet

    • Requires an encryption key
    • Uses a GET request to send data

  2. DataPassPost (recommended)

    • Does not require an encryption key
    • Uses a POST request to send data

DataPassGet

Request

  • Method: GET
  • Url Parameters:
    • campaign_id (required)
    • payload (required)
  • Example: https://form.quotewizard.com/?c={campaign_id}payload={encrypted_data}

Implementation Steps

  1. Obtain Encryption Key

    • Contact our account managers to receive your unique encryption key
    • The key uses AES-128-ECB encryption algorithm
    • This key is specific to your integration and should be kept secure

  2. Prepare Your Data

    • Format your data as a JSON string. Refer to the Schema section to see the required data structure.

  3. Encrypt the Payload

    • Use the provided secret key to encrypt your JSON payload using AES-128-ECB algorithm

  4. URL Encode

    • URL encode the encrypted payload to ensure safe transmission in the query string

  5. Add to Query String

    • Include the encoded payload in the query string as the payload parameter

Result

Router will decrypt the payload and use the data to pre-populate the destination form with the provided information.

DataPassPost

Request

  • Method: POST
  • Url Parameters:
    • campaign_id (required)
    • datapassv2=true (required)
  • Example Url: https://form.quotewizard.com/?c={campaign_id}&datapassv2=true
  • Body: JSON payload with user data (refer to Schema section for structure)

Implementation Steps

DataPassPost is much simpler than DataPassGet - simply send a POST request and handle the response. No encryption key is required.

  1. Prepare Your Data

    • Format your data as a JSON object in the request body
    • Refer to the Schema section to see the required data structure

  2. Send POST Request

    • Make a POST request to the router endpoint with datapassv2=true parameter
    • Include your campaign ID in the c parameter
    • Send your JSON data in the request body

  3. Handle Response
    You will receive a JSON response containing a redirect URL to our funnel. You can do one of the following:

    • Automatic Redirect: Configure your request to follow 302 redirects automatically for immediate user redirection to the form with pre-populated data
    • Manual Redirect: Use the returned redirectUrl from the JSON response if you need to perform additional processing before directing users to the form

Response sample

{
    "redirectUrl": "https://form.quotewizard.com/router/?c={campaign_id}&datapassv2=true&datapassv2id=lAcNZhResPtl740qWyEpxCPWqzXmxw8abcd1k"
}
  • Schema Requirements - Complete schema definitions and payload examples for all supported product types