Buy

Overview

Buy enables customers to find, compare and purchase vehicles from a variety of sellers. This feature supports both new and used vehicles from dealerships, private sellers, and online marketplaces.

The Buy Experience

To purchase a vehicle, follow these steps:

Capture Buyer Details

Start by capturing the buyer’s details, including their name, address, phone number, and email address.

{
  "buyer": {
    "firstName": "John",
    "middleInitial": "A",
    "lastName": "Doe",
    "address": "123 Elm St",
    "city": "Springfield",
    "state": "IL",
    "zip": "62704",
    "phone": "555-1234",
    "email": "johndoe@gmail.com",
    "dob": "01/01/1980",
    "ssn": "123-45-6789",
    "driversLicenseNumber": "123456789",
    "driversLicenseState": "IL",
    "driversLicenseExpiration": "01/01/2028"
  }
}

Configure the Deal

Configure the deal by selecting the vehicle, entering the sales price, down payment, taxes & fees, trade-in value, and shipping cost. Calculate the total cost of the deal.This will generate the Buyer’s Order and necessary paperwork for the transaction.

{
  "deal": {
    "ymm": "2022 Ford F-150 XL",
    "vehicle": {
      "vin": "1FTEW1EP5NFA65544",
      "year": 2022,
      "make": "Ford",
      "model": "F-150",
      "trim": "XL",
      "series": "XL 4dr SuperCrew 4WD 5.5 ft. SB (3.3L 6cyl 10A)",
      "style": "Crew Cab Pickup",
      "drivetrain": "4WD",
      "engine": "3.3L 6Cyl Gasoline",
      "transmission": "Automatic",
      "interiorColor": "Black",
      "exteriorColor": "Black",
      "mileage": 25103,
      "pickupZip": "30349"
    },
    "zip": "62704",
    "salesPrice": 44996,
    "downPayment": 5000,
    "taxes&Fees": 3655.72,
    "tradeIn": 0,
    "shippingCost": 1377,
    "totalCost": 44524.72
  }
}

Buyer Authorization

Obtain buyer authorization and power of attorney to act on their behalf in the transaction.https://notarize.poa.vin/{VIN}?name=John+A+Doe&address=123+Elm+St,+Springfield,+IL+62704

Facilitate Transaction

Facilitate the transaction by generating a checkout link for the buyer to complete the purchase. This link will include the total cost of the deal and payment options.Once the payment is successful, the buyer will receive a receipt and the transaction will be complete with the vehicle reserved for delivery to the buyer’s address.

{
  "checkoutLink": "https://checkout.driv.ly/deal_1FTEW1EP5NFA65544"
}

Schedule Delivery

Schedule the delivery of the vehicle to the buyer’s address.

{
  "delivery": {
    "address": "123 Elm St, Springfield, IL 62704",
    "date": "06/15/2024",
    "time": "10:00 AM - 12:00 PM"
  }
}

Commerce

Resources

API Reference

Overview

The Buy Experience

​Overview

​The Buy Experience

Overview

The Buy Experience