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.
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.
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.
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.
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.
Step 5
Your insurance certificate is read for its expiry date, and your revenue licence for its number and its expiry date.
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.
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
Read next
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.