Test your integration
Test errors
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
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.
We recommend handling this error by re-prompting the user to authorize their vehicle and adding a message like in the example below.
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:
- Have the hardware required for internet connectivity
- Belong to the makes and models Smartcar is compatible with
- 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.
VIN | |
---|---|
smartcar@vehicle-incompatible.com | 0SCAUDI012FE3B132 |
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.
VIN | |
---|---|
smartcar@invalid-subscription.com | 0SCAUDI0155C49A95 |
AUTHENTICATION_FAILED
(v2.0) or a VOA_000
(v1.0) error, the user will need to be prompted to re-connect their vehicle. Smartcar Connect Re-authentication makes the process of re-authenticating a user much more seamless. In addition, the AUTHENTICATION_FAILED
error provides a partially constructed URL for the re-authentication flow inside the resolution
object. 2. Request errors
In the event of an AUTHENTICATION_FAILED error, you’ll receive a reauth URL in the error response body that you can use to prompt the user to reauthenticate their connected service account. You will need to provide a redirect URI as a parameter.