POST
/
checkoutCart_oncreate_v2
/
:legacy
Create a checkout cart (legacy)
curl --request POST \
  --url https://api.ekhodealer.com/checkoutCart_oncreate_v2/:legacy \
  --header 'Content-Type: application/json' \
  --data '{
  "id": "<string>",
  "cancelUrl": "<string>",
  "oemKey": "<string>",
  "oemId": "<string>",
  "nativeDefaultCheckoutUrl": "https://www.rideoem.com/checkout",
  "registrationState": "AL",
  "items": [
    {
      "productId": "<string>",
      "count": 123,
      "name": "<string>",
      "basePrice": 123,
      "imgUrl": "<string>",
      "specs": [
        {
          "name": "<string>",
          "price": 123,
          "option": "<string>",
          "description": "<string>",
          "id": "<string>"
        }
      ],
      "estimatedProductionTime": 123,
      "estimatedDeliveryTime": 123,
      "year": 123,
      "id": "<string>",
      "color": "<string>",
      "totalPrice": 123,
      "boltOnAccessories": [
        "<string>"
      ],
      "boltOnVehicleIds": [
        "<string>"
      ],
      "typeOfOrder": "ante_preorder",
      "variantId": "<string>",
      "description": "<string>",
      "sku": "<string>",
      "stage": "signOff",
      "orderFee": 123,
      "vipOrderFee": 123,
      "vin": "<string>",
      "odometerReading": 123,
      "estimatedDeliveryDate": 123,
      "estimatedProductionDate": 123,
      "shippingFee": 123,
      "pickUpFee": 123,
      "preorderProdStart": "<string>",
      "metadata": {
        "existingPayments": [
          {
            "amount": 123,
            "type": "PREORDER",
            "recipient": "OEM",
            "preorderId": "<string>",
            "paymentIntentId": "<string>"
          }
        ]
      }
    }
  ],
  "boltOnsAlreadyAssigned": true,
  "ecommUserId": "<string>",
  "ecommOrderId": 123,
  "ekhoCheckoutCartId": "<string>",
  "orderCreationType": "ORGANIC",
  "source": "<string>",
  "linkUseType": "SINGLE_USE",
  "customLinkConfig": {
    "linkName": "<string>",
    "checkoutPaymentOverride": {
      "STANDARD_RESERVATION": {
        "paymentTypeEnum": "STANDARD_RESERVATION"
      },
      "CHECKOUT_FULL_PAYMENT": {
        "paymentTypeEnum": "CHECKOUT_FULL_PAYMENT",
        "fullPaymentDiscountPerc": 123
      },
      "LOAN_DOWNPAYMENT": {
        "paymentTypeEnum": "LOAN_DOWNPAYMENT",
        "checkoutDownPaymentPerc": 123
      }
    },
    "salespersonEmail": "<string>",
    "prefilledInfo": {
      "buyerFullName": "<string>",
      "buyerPhone": "<string>",
      "buyerEmail": "<string>",
      "selectedPaymentOption": "STANDARD_RESERVATION",
      "selectedDeliveryOption": "PICK_UP",
      "selectedRegistrationOption": "EKHO",
      "selectedPickUpLocationId": "<string>",
      "shippingAddress": {
        "addressString": "<string>",
        "addressLineOne": "<string>",
        "addressLineTwo": "<string>",
        "city": "<string>",
        "county": "<string>",
        "state": "<string>",
        "zip": "<string>"
      },
      "registrationAddress": {
        "addressString": "<string>",
        "addressLineOne": "<string>",
        "addressLineTwo": "<string>",
        "city": "<string>",
        "county": "<string>",
        "state": "<string>",
        "zip": "<string>"
      },
      "mailingAddress": {
        "addressString": "<string>",
        "addressLineOne": "<string>",
        "addressLineTwo": "<string>",
        "city": "<string>",
        "county": "<string>",
        "state": "<string>",
        "zip": "<string>"
      },
      "regAddressSameAsShipping": true,
      "mailingAddressSameAsShipping": true
    }
  },
  "preorderId": "<string>",
  "brandKey": "<string>",
  "reqManulDeliveryUpdates": true
}'
{
  "checkoutUrl": "<string>",
  "ekhoCheckoutCartId": "<string>",
  "message": "<string>"
}

Body

application/json

The schema of the payload our checkoutCart_oncreate/ endpoint receives and enriches to create a CheckoutCart object

​
cancelUrl
string
required

The url to redirect to if the user cancels the checkout process

​
oemKey
string
required

The oemKey of the OEM that this checkout cart belongs to

​
nativeDefaultCheckoutUrl
string
required

The OEMs native checkout page URL, which we will route the buyer to if a) the buyer doesn't have vehicles in their cart, or b) we don't support the state they want to register their vehicle in (if included)

Example:

"https://www.rideoem.com/checkout"

​
items
object[]
required

An array of items that represent the vehicles and accessories in the cart

​
id
string

The id of the checkout cart. If an ID is included, then we will use this ID for the newly created checkout cart (and overwrite any existing cart with the same ID)

​
oemId
string

The oemId of the OEM that this checkout cart belongs to (optional -- if not provided we will grab need to default to the main oemId)

​
registrationState
enum<string>

The state (abbreviation) the buyer wants to register their vehicle in. Helps us determine whether or not we can facilitate this sale

Available options:
AL,
AK,
AZ,
AR,
CA,
CO,
CT,
DE,
FL,
GA,
HI,
ID,
IL,
IN,
IA,
KS,
KY,
LA,
ME,
MD,
MA,
MI,
MN,
MS,
MO,
MT,
NE,
NV,
NH,
NJ,
NM,
NY,
NC,
ND,
OH,
OK,
OR,
PA,
RI,
SC,
SD,
TN,
TX,
UT,
VT,
VA,
WA,
WV,
WI,
WY
​
boltOnsAlreadyAssigned
boolean

Whether or not we need to assign bolt-ons to the vehicles in the cart. If true, all vehicles' boltOnAccessories arrays will be set and all accessories' boltOnVehicleIds arrays will be set. Default value (if not provided) is false

​
ecommUserId
string

Optional. The id of the user in the ecomm system

​
ecommOrderId
number

Optional. The id of the order in the ecomm system

​
ekhoCheckoutCartId
string

Optional. If you would like for us to overwrite an existing checkoutCart with the same id, provide the id here. If you don't provide this, we will create a new checkoutCart with a new id

​
orderCreationType
enum<string>

Determines the type of order being created. If not provided, we will default to "ORGANIC". ANTE_PREORDER -> cart for a preorder, PREORDER -> cart created from a preorder, EXISTINGORDER -> cart created for an existing order, OEMORIGINATED -> cart created by OEM sales rep, ORGANIC -> cart created by buyer on OEM website

Available options:
ORGANIC,
PREORDER,
EXISTINGORDER,
OEMORIGINATED,
ABANDONEDCART,
ANTE_PREORDER
​
source
string

The source of the checkout cart. Useful for tacking purposes to know where the OEM is placing this link - and thus where buyers are coming from. Example: "facebook"

​
linkUseType
enum<string>

The type of link that we're creating. If not provided, we will default to "MULTI_USE". SINGLE_USE -> link can only be used once, MULTI_USE -> link can be used multiple times

Available options:
SINGLE_USE,
MULTI_USE
​
customLinkConfig
object

Custom configuration for this checkout cart

​
preorderId
string

The id of the preorder. Only relevant for carts created from Ekho preorders

​
brandKey
string

The brand key of the branded vehicle(s) that exist in this checkout cart

​
reqManulDeliveryUpdates
boolean

true if all delivery updates for this vehicle should be manually set. Optional for backwards compatibility. Default is false. Overrides value on OEM vehicle object. Should only exist on vehicle items

Response

Successfully processed the checkout cart. Returns the checkoutUrl to redirect the user to to complete the checkout process. Can either be the OEMs native checkout page or our own checkout page, depending on whether or not Ekho is "turned on" in state the user wants to title their vehicle in AND whether or not there is at least 1 vehicle among the items

​
checkoutUrl
string

The url to redirect the user to to complete the checkout process. If we're checking the buyer out via Ekho Dealer's checkout out, this url will whatever we were sent as the nativeDefaultCheckoutUrl in the request body.

​
ekhoCheckoutCartId
string

The id of the checkout cart we created. This will be null if we aren't redirecting the buyer to Ekho Dealer's checkout page.

​
message
string

A human readable message describing why we're redirecting the buyer to the checkoutUrl we return