Driver's licence scanning for visitor access control in South Africa
Scanning a visitor's driver's licence at a gate or reception desk in South Africa means reading the encrypted PDF417 barcode on the back of the card and turning it into a name, ID number, licence number, expiry date and photo. Doing that reliably needs three things: a scanner or camera that returns the barcode's raw bytes, a decoder that can decrypt South African licences, and a system that stores only what it needs.
This guide covers what an access control or visitor management system should capture, which documents it can read, and what to check before choosing a decoding service.
What a gate system actually needs from a scan
Typing details from a card is slow and error-prone, and it is where fake or mistyped entries come from. A scan gives you exact values in a second or two. The fields that matter at a gate are:
- Identity: surname, initials and South African ID number
- Licence validity: the licence number and the valid-to date, so an expired licence can be flagged
- Photo: the image stored inside the barcode, so a guard can compare it with the person in the car and with the printed photo
- Vehicle: registration number, make, model and colour, read from the licence disc on the windscreen
The barcode photo is worth highlighting. It is encoded in the card when it is made, so a card whose printed photo has been tampered with will not match it.
Which documents you can read
Visitors present whatever they have with them, so a system that reads only one document type sends people back to the manual register. Driverscan decodes:
| Document | Barcode | Useful fields |
|---|---|---|
| South African driver's licence card | PDF417, binary and encrypted | Names, ID number, licence number, codes, expiry, photo |
| Temporary driver's licence | Text starting %TDL | Licence details |
| Smart ID card | PDF417, plain text | Surname, full names, sex, ID number, birth date, citizenship status |
| Vehicle licence disc | PDF417, text starting %MVL | Registration, make, model, colour, VIN, expiry |
| Namibian driver's licence | Binary barcode | Names, licence number, codes, expiry |
Pairing the driver's licence with the disc on the vehicle gives you both who came in and what they drove, from two scans.
Hardware: phone or dedicated scanner
Either works, provided it hands over the barcode bytes untouched.
- Android handhelds and phones with a PDF417-capable scanning library are the common choice for guard huts. Configure the library to return raw binary, then hex-encode it before sending it on.
- Fixed desktop scanners suit reception desks. Check the model can output binary rather than keyboard-wedge text, which corrupts encrypted data.
- No raw bytes at all? A photo of the barcode also works: Driverscan's
/api/pdf417endpoint accepts a JPG, PNG or PDF of up to 10 MB and does the barcode reading itself.
What to check before choosing a decoding service
- Coverage. Does it read the licence, the smart ID card and the disc, or only one of them?
- Photo extraction. Many decoders return text fields only. The photo is the field that stops someone using another person's licence.
- Speed at the boom. A queue forms quickly at a gate. Driverscan's licence decoding is pure computation on its own servers, with no third-party call in the path, and completes in milliseconds once the request arrives.
- What you pay for. Driverscan bills per successful decode. A malformed or partial scan is rejected with a reason and is not charged, so a bad read at the gate does not cost you.
- Track record. The licence format has several quirks that only show up in volume. Driverscan has been decoding South African licences since 2016.
Personal information and POPIA
A licence scan collects names, ID numbers and a photo, all of which are personal information under the Protection of Personal Information Act (POPIA). The estate, complex or business running the gate is responsible for how it is used. In practice that means telling visitors why the scan is taken, keeping only the fields you need, deciding how long the visitor log is kept, and restricting who can see it. A decoder returns more fields than most gate systems need; you do not have to store them all.
Integrating
Driverscan is a REST API, so it fits behind any visitor management app, gate controller or reception tablet. The technical detail, including request examples and the response fields, is in how to decode the encrypted South African driver's licence barcode. For how the smart ID card differs, see what the smart ID card barcode contains.
Try Driverscan
Driverscan is a REST API run by Apex Technology. Register for an account to get an API token and the full documentation, or contact sales about volume pricing.