Skip to main content

How to Integrate a Vehicle QR Code

QR codes enable users to start a ride with the spotted Dott vehicle.

How does it work:

  1. A user scans a QR code on a Dott (or former Tier) vehicle.
  2. You decode the QR code. Its value contains one of the following formats:
    • https://go.ridedott.com/vehicles/{IDENTIFICATION_CODE}.
    • https://v.ridedott.com/{IDENTIFICATION_CODE} (this is considered legacy).
    • https://tier.app/{MODEL}{IDENTIFICATION_CODE}.
    • https://qr.tier-services.io/{MODEL}{IDENTIFICATION_CODE}.
  3. You make a call to the SearchVehicle API in the Vehicles service. It requires the uri query parameter which is the URI obtained in the previous step. The API returns the Vehicle resource or an error in case of an invalid request.
  4. You retrieve the vehicleId from the Vehicle name property. Its value has the following format: vehicles/{vehicleId}. The second segment is the 20-character vehicleId that is required for starting a trip.

Note: The IDENTIFICATION_CODE is a unique identifier for the vehicle of 6 alphanumeric characters. The MODEL is a unique identifier for the vehicle model of 2 alphanumeric characters.