Skip to content
MageRide

Chapter 3

Photographing your documents

Every camera slot in the app opens the same scanner, and it has one control worth learning properly. A clear photograph is the difference between a vehicle approved in minutes and one waiting on a person.

  1. Step 1

    Tap any capture slot — licence, insurance, revenue licence, vehicle photo — and the same document scanner opens: a live camera with a frame drawn over what it can see.

  2. Step 2

    The app guesses where the edges of the document are and puts a four-cornered frame on them. Drag the corners so the whole document sits inside the frame and fills it.

    The guess is only a starting point. If it has caught the table rather than the paper, move the corners yourself — what you leave inside the frame is exactly what gets sent.

  3. Step 3

    Use photo straightens and crops what you framed, and uploads that. Retake starts over, and there is a flash for a dark yard. You can pick an existing photo from your gallery instead, though a fresh capture usually reads better.

  4. Step 4

    Your driving licence, front and back, is read for the licence number, the expiry, your NIC number and the classes you are licensed for.

  5. Step 5

    Your insurance certificate is read for its expiry date, and your revenue licence for its number and its expiry date.

  6. Step 6

    The two vehicle photographs are read for the number plate, which is matched against the registration number you typed at step 1. A plate that cannot be read, or that does not match, holds that step up.

  7. Step 7

    Everything the app reads is shown back to you before it goes anywhere, and you can correct any of it.

    Correcting a field is not a failure. It makes that value one a person will confirm rather than one the app could stand behind on its own, and the next chapter is what happens to it.

Source

  • specs/MageRide_Functional_Walkthrough.md#scenario-102-a-driver-captures-a-document-by-fitting-it-in-the-frame
  • specs/user-requirements-document.md#epic-24-new-2026-06-28-change-set-ux-admin-directory
  • specs/user-requirements-document.md#epic-2-vehicle-registration
  • specs/D1_mageride_user_flows.md#f-28-4-driver-document-capture-with-drag-crop-item-6-us-24-6
  • specs/D5_mageride_business_logic.md#br-28-4-onboarding-camera-capture-drag-crop-item-6-al-43
  • specs/D2_mageride_ui_spec.md#scr-da-di-005-document-capture-camera-draggable-corner-crop

Questions about this

How do I start driving with MageRide?
Install the driver app, sign in with your phone number, and register your vehicle in four steps: the vehicle, insurance, revenue licence and photos. You photograph each document in the app — most details are read automatically, and anything unclear is checked by a person before approval.
Can I get my data, or have it deleted?
Both. You can ask for a copy of everything MageRide holds about you and receive it within 30 days, and you can ask for your account and personal data to be erased, also within 30 days — except for records the law requires us to keep.