DealDriver Website Integration Guide - CarZing

Dealer Website Integration Guide


Design Options

$
274 /mo
See Finance Options
*payment details
Modern Medium
Modern Small
Generate Code

Code for Vehicle Listing Pages

Copy Script to Clipboard
Copy HTML to Clipboard

Example Markup

Below is an example of a for-loop that you might use to dynamically add vehicles to a listing page. Carzing code is integrated, with programmatic variables highlighted:
@foreach (vehicle in allVehicles) {
    <div class="vehicle-row">
        <div class="vehicle-header">
            @vehicle.Year @vehicle.Make @vehicle.Model
        </div>
        <div class="vehicle-info">
            @vehicle.DriveTrain @vehicle.Transmission @vehicle.Engine @vehicle.Mileage @vehicle.Doors<br />
            @vehicle.Vin @vehicle.Stock<br />
        </div>
        <div class="vehicle-price">
            @vehicle.Price
        </div>
        <div class="vehicle-buttons">
            <button>View Details</button>
        </div>
        <div class="third-party-widgets">
            <div class="carzing-widget"
             data-carmojo-theme="modern-medium"
             data-carmojo-color-primary="#333333"
             data-carmojo-color-secondary="#EA6624"
             data-carmojo-price="@vehicle.Price"  Add your own dynamic variables like this
             data-carmojo-vin="@vehicle.Vin"
             data-carmojo-primary-image-url="@vehicle.ThumbnailImage">
             </div>
        </div>
    </div>
}

Example Script

Add the script at the bottom of the page, outside of your for-loop:
        <script async="" src="https://www.carzing.com/dealerwebsite/widgetscript/myEncryptedDcid/listing-theme"></script>
    </body>

Example Integration on a Listing Page:

Frequently Asked Questions


  • Q: What if I don't know my DealerCenter ID?
    A: Your Carzing Representative can provide you with this value during the integration process.
  • Q: Can I change the size of the widget?
    A: If you choose our Modern Medium theme, it's responsive in width up to 300px at maximum and down to 150px at minimum. The Modern Small theme has a static height and width, so it cannot be resized.
  • Q: What is the maximum number of characters I can use for the button text?
    A: To accommodate the maximum (300px) size of the Modern Medium theme, we offer a limit of 50 characters. Expect text to be truncated for sizes smaller than 300px.
  • Q: How do I populate the price, vin, and primary image url values?
    A: Depending on your provider, these values should ideally be populated programmatically per vehicle. For the convenience of our DealerCenter customers, these values are pre-populated for our Dealer Websites product.

Design Options

As low as
$222
/mo*
See Pre-Qualified Options
*payment details
Based on a cash down payment of $2,039, loan amount of $9,960, term of 60 months, and an interest rate of 11.99%, on approved credit. Estimated state sales tax of $0 is included.
Modern Medium
Classic
Generate Code

Code for Vehicle Details Pages

Copy Script to Clipboard
Copy HTML to Clipboard

Example Markup

Below is an example with Carzing code integrated using the highlighted dynamic variables:
<div class="vehicle-item">
    <div class="vehicle-image-column">
        <div class="vehicle-image-slider"></div>
    </div>
    
    <div class="vehicle-info-column">
        <div class="vehicle-header">
            @vehicle.Year @vehicle.Make @vehicle.Model
        </div>
        <ul class="vehicle-info-detail">
            <li>@vehicle.Mileage</li>
            <li>@vehicle.StockNo</li>
            <li>@vehicle.Vin</li>
            <li>@vehicle.Color</li>
            <li>@vehicle.Trim</li>
            <li>@vehicle.ColorInt</li>
        </ul>
    </div>

    <div class="vehicle-widget-column">
        <div class="vehicle-price">
            @vehicle.Price
        </div>

         <div class="carzing-calculator"
         data-carmojo-theme="modern-medium"
         data-carmojo-color-primary="#333333"
         data-carmojo-color-secondary="#EA6624"
         data-carmojo-price="@vehicle.Price"  Add your own dynamic variables like this
         data-carmojo-vin="@vehicle.Vin"
         data-carmojo-primary-image-url="@vehicle.ThumbnailImage">
         </div>
    </div>
</div>

Example Script

Add the script at the bottom of the page, outside of any loops:
        <script async="" src="https://www.carzing.com/dealerwebsite/widgetscript/myEncryptedDcid/vdp-theme"></script>
    </body>

Example Integration on a Details Page:

Using the Classic theme, with the Carzing widget pulled to the right:

Frequently Asked Questions


  • Q: What if I don't know my DealerCenter ID?
    A: Your Carzing Representative can provide you with this value during the integration process.
  • Q: How do I populate the price, vin, and primary image url values?
    A: Depending on your provider, these values should ideally be populated programmatically per vehicle. For the convenience of our DealerCenter customers, these values are pre-populated for our Dealer Websites product.

Dealer Info

Use this form to generate all the code you need to build a standalone prequalification form page for your site.

Generate Code

Code

Copy Code to Clipboard
HTML Code

Copy and paste the following HTML code to the Get Pre-Qualified page's placement:

Substitute the corresponding Dealership ID provided by Carzing (highlighted in bold)

Substitute the corresponding Dealership's name (highlighted in bold)


<iframe frameborder="0" width="100%" height="1200px" scrolling="no" 
src="https://{CARZING_DOMAIN_NAME}/DealerWebsite/GetPreQualified?dcId={DC_ID}&dealerName={DEALERSHIP_NAME}"></iframe>
                            

Pre-Qualification form output example

Getting Started

All Carzing API requires the following mandatory HTTP header:
x-com-carzing-api-key - the header should contains the {API_KEY}

All POST requests made to Carzing API should use the following content type:
application/json

API root endpoint
https://{CARZING_DOMAIN_NAME}/api/DealerWS


HTTP Status codes

  • 200 - OK
  • 400 - Bad request
  • 404 - URL Not Found
  • 405 - Method Not Allowed
  • 429 - Rate Limit Exceeded
  • 500 - Internal Error

Submit Pre-qualification information

POST /SubmitPrequalification

Request POST Body:

Substitute the corresponding customer information accordingly (highlighted in bold)


{
    "FirstName":"THOMASE",
    "LastName":"SILUERMAN",
    "PhoneNumber":"(626) 652-2288",
    "DateOfBirth":"08/01/1974",
    "Address":"49840 LEISURE LAKE DR",
    "City":"SOLDOTNA",
    "State":"AK",
    "Zip":"99669",
    "Email":"jonconsumer@nowcom.com",
    "SSN":"",
    "RentMortgage":1100,
    "LengthOfAddressYear":"2,
    "LengthOfAddressMonth":"2,
    "MaxCashDown":2000,
    "MonthlyIncome":5000,
    "LengthOfJobYear":1,
    "LengthOfJobMonth":1,
    "IncomeType":1,
    "TradeInValue":6000,
    "TradeInPayoff":1000,
}
                                

Response:


{
    "Success":true,
    "IsNoHit":false,
    "IsFrozen":false,
    "IsFraudAlert":false,
    "SessionId":"8f2e13f98f40458382658b246f29c6d1"
}
                                

Parameters Values
IncomeType
  • 1 - Computerized Paystub Showing Year-To Date Pay
  • 1 - Computerized Paystub Showing Year-To Date Pay
  • 2 - Computerized Paystub With No Year-To-Date Pay
  • 3 - -Handwritten Paystub Showing Tax Deduction
  • 4 - 3 Months Of Recent Business Bank Statements
  • 5 - 3 Months Of Recent Personal Bank Statements
  • 10 - Permanent Disability Income From An Insurance Company
  • 0 - I do not have one of the required income types listed above
Create Vehicles

POST /ImportVehicles

Request POST Body: (multiple vehicles can be included in the JSON array)

Substitute the corresponding vehicle information accordingly (highlighted in bold)

[{
  "DCCompanyID": "881234",
  "Vin": "J1BF1FK0GU147428",                                         
  "StockNo": "302518",
  "VehiclePrice": 25413,
  "Year": 2014,
  "Make": "Toyota",
  "Model": "Camry",
  "Trim": "SE Sedan 4D",
  "Mileage": 12566,
  "ExteriorColor": "Black",
  "InteriorColor": "Black",
  "BodyType": "Sedan",
  "Doors": "4",
  "Engine": "4-Cyl, 2.5 Liter",
  "DriveTrain": "FWD",
  "FuelType": "Gasoline",
  "Transmission": "Auto, 6-Spd SeqShft",
  "TransmissionType": "Automatic",
  "BodyStyle": "Sedan",
  "Cylinders": "4",
  "HighwayMPG": "35",
  "CityMPG": "25",
  "VehicleClass": "Used",
  "Photos": [
    {
      "ImageUrl": "{PHOTO1_URL}"
    },
    {
      "ImageUrl": "{PHOTO2_URL}"
    }
  ],
  "Equipments": [
    {
      "CodeDescription": "Stability Control",
      "EquipmentType": "Equipment"
    },
    {
      "CodeDescription": "ABS (4-Wheel)",
      "EquipmentType": "Equipment"
    }
  ]
}]
                                    

Response:


[{
    "Success":true,
    "InventoryID":"669923af-c3f5-e511-80f4-005056827101",                                         
    "DCCompanyID": "881234",                                                                                  
    "Vin": "J1BF1FK0GU147428",
    "StockNo": "302518"
}]                                    
                                

Parameters Values
VehicleClass
  • New
  • PreOwned
  • Used
TransmissionType
  • Automatic
  • Manual
Compute Payments

POST /ComputePayment

Mulitple Inventory IDs or combination of DC Company ID, VIN and Stock Number (in the "Inventory" field) can be provided to identify the list of vehicles on which the compute should be performed.

** Note: use "0" as term for the service to determine the longest term

{
                                // FICO should be provided only for 
    // compute based on FICO only (i.e. no pre-qual session has 
    // been established)
    "FICO": 750, 
                                // PreQualSessionId should contain the session ID 
    // from the "Submit Pre-Qualification Response" 
    // when compute based on pre-qual session
    "PreQualSessionId": {SESSION_ID}, 
    "DownPayment": 1500,
    "Term": 72
    "InventoryIDs": [
        "{INVENTORY_ID}",
        "{INVENTORY_ID}"
    ],
                                // As an alternative to InventoryIDs, 
    // client application can provide combination of DC Company ID, 
    // VIN and Stock Number for identifying vehicles
    "Inventory": [
        {
            "DCCompanyID": "881234",                                                                                  
            "Vin": "J1BF1FK0GU147428",
            "StockNo": "302518"
        },                             
        {
            "DCCompanyID": "881234",
            "Vin": "J1BF1FK0GU147429",
            "StockNo": "302519"
        },
    ]
}
                                    

Response:


[{
    "Approved": true,
    "MonthlyPayment": 325,
    "DownPayment": 1500,
    "Term": 60,
    "APR": 4.99,
    "AmountFinanced": 18999,
    "StateTax": 18090,
    "InventoryID": "669923af-c3f5-e511-80f4-005056827101"
}]                                    
                                    
Currently Supported Feeds

Many DMS providers have already been integrated with the Carzing experience. If you currently use one of them, it should be a snap to set up.

These are the providers currently supported:

  • DealerCenter
  • CarsForSale
  • DealerCarSearch
  • Chroma
  • PRcoPower
  • Dealer Socket / Fire
  • Motorcar Marketing
  • Dealer Front- Coming Soon
  • Auto Manager - Coming Soon

Q: What if my DMS isn't listed here?
A: No problem. The Carzing team is happy to work with any DMS to set up your inventory feed.
Data File Format

We support the widely accepted standard HomeNet feed format. The only restriction we add on top of this is the file naming convention (DCID_MMDDYYYY.csv).

For example, if your DCID was 123456, you would use this file format if transmitting on 11/28/2016: 123456_11282016.csv

Q: What if I don't use DealerCenter DMS?
A: If you are not currently a DealerCenter customer with a DCID, the Carzing team will provide you with the number to use.
Data Transfer
Feeds may be transmitted to us over SFTP. We will provide you with unique credentials upon implementation.