> ## Documentation Index
> Fetch the complete documentation index at: https://docs.driv.ly/llms.txt
> Use this file to discover all available pages before exploring further.

# Buy

> Vehicle purchase and payment processing

## 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:

<Steps>
  <Step title="Capture Buyer Details">
    Start by capturing the buyer's details, including their name, address, phone number, and email address.

    ```json theme={null}
    {
      "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"
      }
    }
    ```
  </Step>

  <Step title="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.

    ```json theme={null}
    {
      "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
      }
    }
    ```
  </Step>

  <Step title="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`
  </Step>

  <Step title="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.

    ```json theme={null}
    {
      "checkoutLink": "https://checkout.driv.ly/deal_1FTEW1EP5NFA65544"
    }
    ```
  </Step>

  <Step title="Schedule Delivery">
    Schedule the delivery of the vehicle to the buyer's address.

    ```json theme={null}
    {
      "delivery": {
        "address": "123 Elm St, Springfield, IL 62704",
        "date": "06/15/2024",
        "time": "10:00 AM - 12:00 PM"
      }
    }
    ```
  </Step>
</Steps>