Test error statuses

You can use test mode to verify that your application properly handles various error statuses that Smartcar may return. There are two types of errors that can occur after integrating Smartcar into an application:

  1. Connect errors
  2. Request errors

1. Connect errors

Connect errors are errors that occur during Smartcar Connect. The following section explains the different kinds of Connect errors and how to test them. For more information, please see our API reference.

access_denied

This error occurs when a user denies your application access to the requested scope of permissions. To test this error, launch Smartcar Connect in test mode and select “Deny access” on the permissions screen.

Access Denied

We recommend handling this error by re-prompting the user to authorize their vehicle and adding a message like in the example below.

Access Denied Message

vehicle_incompatible

This error occurs when a user tries to authorize an incompatible vehicle in Smartcar Connect. In order to be compatible, a vehicle must:

  1. Have the hardware required for internet connectivity
  2. Belong to the makes and models Smartcar is compatible with
  3. Be capable of the required permissions that your application is requesting access to

If the user’s vehicle is incompatible, Smartcar will let the user know and offer them to share their vehicle’s VIN, make, model, and year with your application.

We recommend that your application provides a flow for incompatible vehicles like in the example below.

Vehicle Incompatible

Note: This error will never occur if your application uses Connect Compatibility. Connect Compatibility verifies the compatibility of a vehicle before the user enters Smartcar Connect.
To test this error, launch Smartcar Connect in test mode and log in with the email smartcar@vehicle-incompatible.com and any password. If you use Connect Match, please see the table below for a simulated VIN.
EmailVIN
smartcar@vehicle-incompatible.com0SCAUDI012FE3B132

invalid_subscription

This error occurs when a user’s vehicle is compatible but their connected services subscription is inactive because either it has expired or it has never been activated. Smartcar will direct the user to the connected services website to (re-)activate their subscription. However, a user may choose to return back to your application instead, like in the example below.

No Subscription

To test this error, launch Smartcar Connect in test mode and log in with the email smartcar@invalid-subscription.com and any password. If you use Connect Match, please see the table below for a simulated VIN.
EmailVIN
smartcar@invalid-subscription.com0SCAUDI0155C49A95

2. Request errors

Request errors are errors that occur when an API request to a vehicle is unsuccessful. For a full list of all request errors, see our API reference.

The following request errors can be tested using Smartcar’s test mode.

  1. vehicle_owner_action_required: This error occurs when a user has either changed the password of their connected services subscription or their subscription has expired. You should prompt your user to take the necessary action.
  2. vehicle_state_error: This error occurs when a vehicle is unable to perform the request in its current state. For example, the vehicle might be outside of a cellular coverage area or the vehicle’s doors might stand open while a lock request is initiated. See the error codes below for a detailed list of all possible scenarios. Depending on the scenario, you should try sending another request at a later time or prompt your user to take the necessary action.

To test these errors, launch Smartcar Connect in test mode and log in with one of the following emails and any password. Then make a request to any non-static vehicle endpoints (all endpoints under the /vehicles resource, excluding the VIN, vehicle attributes, and application permissions endpoints).

ErrorError codeDescriptionEmailVIN
vehicle_owner_action_requiredVOA_000Vehicle authentication failed. Please prompt the vehicle owner to log in again using Connect.smartcar@voa-000.vehicle-owner-action-required.com0SCAUDI01391D9CA7
vehicle_owner_action_requiredVOA_001Connected services subscription invalid or expired. Please prompt the vehicle owner to reactivate their subscription.smartcar@voa-001.vehicle-owner-action-required.com0SCAUDI01AEF8D583
vehicle_state_errorVS_000Vehicle state cannot be determined.smartcar@voa-000.vehicle-state-error.com0SCAUDI019D6FC7A6
vehicle_state_errorVS_001Some of the vehicle's doors are open.smartcar@voa-001.vehicle-state-error.com0SCAUDI0169A043C2
vehicle_state_errorVS_002Some of the vehicle's trunks are open.smartcar@voa-002.vehicle-state-error.com0SCAUDI016B51ACF3
vehicle_state_errorVS_003The vehicle's hood is open.smartcar@voa-003.vehicle-state-error.com0SCAUDI01D6B3233E
vehicle_state_errorVS_004Charging plug is not connected to the vehicle.smartcar@voa-004.vehicle-state-error.com0SCAUDI01BF2D854E
vehicle_state_errorVS_005Vehicle is fully charged.smartcar@voa-005.vehicle-state-error.com0SCAUDI01E99C2F91
vehicle_state_errorVS_006Vehicle is asleep.smartcar@voa-006.vehicle-state-error.com0SCAUDI019063631B
vehicle_state_errorVS_007Vehicle is offline.smartcar@voa-007.vehicle-state-error.com0SCAUDI01CC0B946C
vehicle_state_errorVS_008Vehicle's ignition is switched on.smartcar@voa-008.vehicle-state-error.com0SCAUDI01C940E389
vehicle_state_errorVS_009Vehicle is moving.smartcar@voa-009.vehicle-state-error.com0SCAUDI0179F360C5
vehicle_state_errorVS_010Remote access is disabled.smartcar@voa-010.vehicle-state-error.com0SCAUDI01E7AC5E5B
vehicle_state_errorVS_011Vehicle is charging.smartcar@voa-011.vehicle-state-error.com0SCAUDI0172704858