Website Integration Guide

Listing Widget Vehicle Details Widget PreQual Widget Prequal Form Embed Inventory Feeds API

Listing Widget Generator

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

Widget Code

Copy Script to Clipboard
Copy HTML to Clipboard
Back to Options
  • 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.
  • Q: What should I do if the widget looks distorted?
    A: If you encounter any strange sizing or distortion issues with the widget, there may be a case of style inheritance from existing CSS. The CarZing team is happy to advise if this happens to you. Otherwise, consider that the widget is rendered directly on your site. Try working your way up through parent elements until you find something setting an inherited static height, width, padding, or margins.
  • Q: All of my widgets are showing turned down or no results. What's wrong?
    A: The best course of action in these cases is to contact your CarZing Representative. However, you may also check to make sure that your inventory feed has been transferred to us successfully. Be advised that there may be a short delay while we sync your inventory.
  • Q: I don't like the payment results I'm seeing. Is there anything I can do to customize the results?
    A: We fully support the implementation of any lender rate table or custom rate table you'd like to use. Contact your CarZing representative for assistance in getting this set up.
  • Use the Widget Positioning options to conveniently center or float the widget.
    These are simple classes that are added automatically to the markup via the code generator above. This way, you don't have to rely on custom css or in-line styles to wrestle with the positioning of the widget. Use the "none" option to remove any such positioning if you'd still like to apply your own styles for this purpose.
  • Responsiveness is built into the widget, but still have size requirements
    The widgets will automatically resize in width until they hit certain minimum and maximum sizes. The heights also have a minimum size requirement. These requirements vary depending on the theme you've chosen. After considering this, drop the HTML markup into a parent element that is sized for your site's own size requirements.
  • The display of Teaser Rate values is optional
    Many dealers only want to show customers numbers after they've submitted their prequalification, and we offer this as a configurable option with the CarZing widgets. Simply set the "Show Calculator for Teaser Rates" option to "no" in the code generator above.

Details Widget Generator

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

Widget Code

Copy Script to Clipboard
Copy HTML to Clipboard
Back to Options
  • 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.
  • Q: What should I do if the widget looks distorted?
    A: If you encounter any strange sizing or distortion issues with the widget, there may be a case of style inheritance from existing CSS. The CarZing team is happy to advise if this happens to you. Otherwise, consider that the widget is rendered directly on your site. Try working your way up through parent elements until you find something setting an inherited static height, width, padding, or margins.
  • Q: All of my widgets are showing turned down or no results. What's wrong?
    A: The best course of action in these cases is to contact your CarZing Representative. However, you may also check to make sure that your inventory feed has been transferred to us successfully. Be advised that there may be a short delay while we sync your inventory.
  • Q: I don't like the payment results I'm seeing. Is there anything I can do to customize the results?
    A: We fully support the implementation of any lender rate table or custom rate table you'd like to use. Contact your CarZing representative for assistance in getting this set up.
  • Use the Widget Positioning options to conveniently center or float the widget.
    These are simple classes that are added automatically to the markup via the code generator above. This way, you don't have to rely on custom css or in-line styles to wrestle with the positioning of the widget. Use the "none" option to remove any such positioning if you'd still like to apply your own styles for this purpose.
  • Responsiveness is built into the widget, but still have size requirements
    The widgets will automatically resize in width until they hit certain minimum and maximum sizes. The heights also have a minimum size requirement. These requirements vary depending on the theme you've chosen. After considering this, drop the HTML markup into a parent element that is sized for your site's own size requirements.
  • The display of Teaser Rate values is optional
    Many dealers only want to show customers numbers after they've submitted their prequalification, and we offer this as a configurable option with the CarZing widgets. Simply set the "Show Calculator for Teaser Rates" option to "no" in the code generator above.

PreQual Widget Generator

Get Pre-Qualified
Generate Code

Widget Code

Copy Script to Clipboard
Copy HTML to Clipboard
Back to Options
  • 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.
  • Q: What should I do if the widget looks distorted?
    A: If you encounter any strange sizing or distortion issues with the widget, there may be a case of style inheritance from existing CSS. The CarZing team is happy to advise if this happens to you. Otherwise, consider that the widget is rendered directly on your site. Try working your way up through parent elements until you find something setting an inherited static height, width, padding, or margins.
  • Use the Widget Positioning options to conveniently center or float the widget.
    These are simple classes that are added automatically to the markup via the code generator above. This way, you don't have to rely on custom css or in-line styles to wrestle with the positioning of the widget. Use the "none" option to remove any such positioning if you'd still like to apply your own styles for this purpose.
  • Responsiveness is built into the widget, but still have size requirements
    The widgets will automatically resize in width until they hit certain minimum and maximum sizes. The heights also have a minimum size requirement. These requirements vary depending on the theme you've chosen. After considering this, drop the HTML markup into a parent element that is sized for your site's own size requirements.

Prequal Form Generator

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

Generate Code

Form Code

Copy Code to Clipboard
Back to Options
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":"{FIRST NAME}",
"LastName":"{LAST NAME}",
"PhoneNumber":"{PHONE NUMBER}",
"DateOfBirth":"{DATE OF BIRTH}",
"Address":"{STREET ADDRESS}",
"City":"{CITY}",
"State":"{STATE ABBR}",
"Zip":"{ZIP}",
"Email":"{EMAIL ADDRESS}",
"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.
×

Favorite Limit Reached

You can only have up to favorite vehicles.

Loading
Please Wait