Um passaporte dá um presente a quem o processa: a zona de leitura mecânica. Um bloco de letras maiúsculas, dígitos e caracteres de preenchimento < na parte de baixo da página de dados, com dígitos verificadores calculados sobre os seus campos. Você lê a zona, recalcula os dígitos e sabe se a leitura é coerente antes de confiar em um único campo.
Uma carteira de motorista normalmente não oferece nada disso. A maioria dos emissores não imprime nenhuma zona de leitura mecânica na carteira, então não há nada para recalcular. Desenvolvedores que montaram o primeiro fluxo com passaportes costumam descobrir isso do jeito difícil, quando o código que "valida a MRZ" encontra um cartão sem zona e passa a tratar uma carteira perfeitamente válida como erro.
Este post é sobre esse caso. O que uma carteira traz no lugar da zona, o que uma API de reconhecimento pode e não pode dizer sobre ela, e como verificar os campos você mesmo quando não há dígitos verificadores em que se apoiar. As citações da AAMVA e da UE foram traduzidas por nós; os originais estão em inglês.
Este é o blog do doc.cheap, uma API de OCR para passaportes e documentos de identidade. Leia a parte sobre o produto tendo isso em mente.
O que uma carteira traz no lugar
Não existe um formato único de carteira de motorista. Cada emissor desenha o próprio cartão, e os padrões que existem definem o que o cartão deve conter e como deve ser organizado, não uma sequência fixa para analisar.
América do Norte: um código de barras no verso. A American Association of Motor Vehicle Administrators publica o AAMVA DL/ID Card Design Standard para os cartões emitidos pelos seus membros. A edição de 2026 tem um anexo intitulado "Código de barras PDF417 obrigatório", que diz: "A simbologia de código de barras bidimensional PDF417 é a tecnologia mínima obrigatória de leitura mecânica que deve estar presente nos documentos DL/ID em conformidade". O mesmo anexo acrescenta: "Todos os dados obrigatórios e opcionais devem estar sem criptografia". Ou seja, um cartão em conformidade traz os dados do titular duas vezes: impressos na frente e codificados em um código de barras bidimensional que qualquer pessoa com um decodificador consegue ler.
A UE: um modelo de cartão comum, lido pela face. A página do Your Europe sobre troca e reconhecimento de cartas de condução descreve a carteira atual como "o novo formato padrão da UE (cartão com foto de plástico, do tamanho de um cartão de crédito)". O layout é comum, mas o que você lê nele é o texto impresso. Carteiras antigas de papel também continuam em circulação: a mesma página diz que, "se você tem uma carta de condução da UE do modelo antigo, ainda pode usá-la em todos os países da UE", e que essa carteira precisa ser trocada "até 2033, no máximo".
A camada internacional. A própria página da AAMVA observa que o trabalho rumo a um padrão internacional de carteira acontece na ISO, e que "a norma internacional (18013) estabelece diretrizes sobre o formato e o conteúdo das carteiras de motorista de veículos automotores (DL)". Ela lista as tecnologias que a norma trata, entre elas "códigos de barras, unidimensionais e bidimensionais" e "reconhecimento óptico de caracteres". Em outras palavras, a norma deixa o emissor escolher; ela não entrega a você uma zona com dígitos verificadores.
O resultado prático para quem processa o documento:
| Passaporte | Carteira de motorista | |
|---|---|---|
| Zona de leitura mecânica | Sempre, na página de dados | Normalmente nenhuma |
| Dígitos verificadores que você pode recalcular | Sim, sobre a zona | Nenhum, quando não há zona |
| Uma segunda cópia dos dados | A zona | Um código de barras, quando o emissor imprime um (normalmente no verso) |
| Data de validade | Impressa na página de dados | Impressa quando a carteira tem uma; algumas valem para a vida toda |
| O que diz que a leitura é coerente | A zona comparada com a página impressa | As suas próprias verificações sobre os campos impressos |
Por que "sem zona" não pode significar "inválido"
Se o seu fluxo começou com passaportes, ele provavelmente se divide pela zona: aprovada, segue; reprovada, pede uma nova foto. Uma carteira acrescenta uma terceira resposta, e ela é a mais comum.
O doc.cheap informa a zona como um único veredito, mrz.status, com três valores. passed significa que a zona está presente e todos os dígitos verificadores foram validados. failed significa que uma zona foi lida e algo nela não bateu. absent significa que o documento não tem zona – e então reason, lines e text são todos null. O guia da carteira de motorista diz isso com clareza: "Trate absent como um resultado comum, não como um erro."
O resto do documento não é afetado. Uma carteira é reconhecida pela face impressa como qualquer outro documento, e meta.status volta como recognized. Então a divisão que você quer não é "zona aprovada ou rejeição", e sim:
failed– algo em uma zona não bateu; peça uma foto melhor.passed– a zona foi conferida; siga em frente.absent– não havia nada para conferir; siga para as suas próprias verificações de campos, logo abaixo.
Lendo uma com uma única chamada de API
Uma carteira vai para o mesmo endpoint de um passaporte, com o mesmo corpo: um POST /v1/scans com a foto em base64 dentro de um JSON. A chave pública de sandbox sk_sandbox_public funciona sem conta. Use-a com uma imagem de teste, nunca com uma carteira real: cada scan feito com a chave pública fica guardado por um ano para o próprio registro do serviço.
curl -X POST https://api.doc.cheap/v1/scans \
-H "Authorization: Bearer sk_sandbox_public" \
-H "Content-Type: application/json" \
-d "{\"image\": \"$(base64 < licence-front.jpg | tr -d '\n')\"}"
As partes da resposta que importam para uma carteira são assim. Todos os valores são inventados, e o Estado emissor é UTO, o Estado fictício usado pelos documentos de amostra:
{
"meta": { "status": "recognized", "billed": true, "confidence": "high" },
"document": {
"country": "UTO",
"number": "DL0000000",
"issue_date": "2024-05-02",
"expiry_date": "2034-05-01",
"is_expired": false,
"days_remaining": 2725
},
"holder": {
"surname": "SPECIMEN",
"given_names": "ALEX JORDAN",
"birth_date": "1990-01-01"
},
"fields": [
{ "id": "dl_class@0", "name": "dl_class", "label": "Driving-licence class",
"category": "document", "value": "B, BE", "language": "English", "confidence": "high" },
{ "id": "authority@0", "name": "authority", "label": "Issuing authority",
"category": "document", "value": "UTOPIA LICENSING OFFICE", "language": "English", "confidence": "medium" }
],
"mrz": { "status": "absent", "reason": null, "lines": null, "text": null },
"authenticity": { "overall": "not_checked", "checks": [] }
}
O que ler nela:
fieldsé onde ficam os dados próprios da carteira. O catálogo de campos lista o que uma carteira costuma trazer:surname,given_names,birth_date,document_number,dl_classoupermit_class,issue_date,expiry_date,addresseauthority. As partes do endereço (address_street,address_city,address_state,address_postal_code) também são publicadas separadamente, além do endereço inteiro. O conjunto é aberto, então um campo que o vocabulário não nomeia é publicado mesmo assim, na categoriaother.- Use
idcomo chave, nãoname. Uma carteira impressa em dois alfabetos retorna uma entrada por idioma com o mesmoname; só oidé único. document.expiry_date,is_expirededays_remainingsão calculados a partir da data de validade impressa, contando a partir do dia do scan.
O que um código de barras acrescenta e o que a API faz com ele
Um código de barras decodificado não ganha um grupo próprio na resposta. Os valores dele chegam em fields junto com todo o resto, e images.barcode traz um recorte dele quando foi possível extraí-lo.
Há um detalhe prático. O endpoint lê uma imagem por chamada, e um emissor que imprime código de barras costuma colocá-lo no verso do cartão. Quando você precisar do que o código de barras traz, envie o verso como um scan separado e junte os dois resultados você mesmo. Essa junção é também o seu melhor substituto para os dígitos verificadores: duas leituras independentes do mesmo cartão, que devem coincidir.
Validando uma carteira sem dígitos verificadores
Sem zona, a coerência fica por sua conta. Nenhuma destas verificações prova que uma carteira é autêntica; elas pegam leituras erradas e entradas claramente incorretas antes que cheguem ao seu banco de dados.
- Datas em ordem.
birth_dateantes deissue_date,issue_dateno dia do scan ou antes,expiry_datedepois deissue_date. Uma leitura que quebra essa ordem é um erro de leitura ou uma foto ruim. - Validade tirada do documento, não de uma fórmula. Os prazos de validade mudam de emissor para emissor – o exemplo da própria página da UE é uma carteira do Chipre "válida por 15 anos, em vez de 10 anos como na Itália". Leia a data no cartão; não a calcule.
- Preveja a ausência de data de validade. A mesma página da UE menciona "cartas de condução da UE que são válidas por toda a vida". Quando nenhuma data de validade foi lida,
expiry_date,is_expirededays_remainingsãonulljuntos, e o campo derivadodays_to_expiretambém énull. Decida o que o seu fluxo faz nesse caso; não tratenullsem querer nem como vencida nem como válida. - A categoria, não só a existência. Se você precisa de alguém habilitado para carro, procure essa categoria em
dl_classoupermit_classem vez de só verificar que existe uma carteira. O valor é texto impresso, comoB, BE, então separe-o antes de comparar, e compare com as categorias que a sua própria jurisdição define. - Frente contra verso. Quando o cartão tem código de barras, escaneie os dois lados e compare o nome, a data de nascimento e o número do documento. Uma divergência justifica uma segunda foto.
- Contra o que o usuário digitou. Compare
holder.surnameeholder.birth_datecom o formulário que o seu usuário preencheu, normalizados do mesmo jeito. - A confiança como sinal. Cada leitura traz uma faixa –
high,mediumoulow. Uma faixalowem um campo do qual você depende é um bom motivo para pedir uma nova foto.
Quanto custa um scan quando não há zona
Com uma chave real, um scan consome um crédito quando o tipo de documento foi determinado e uma de três coisas é verdade: uma zona foi lida e os dígitos verificadores dela foram validados, cinco ou mais campos da zona visual foram lidos, ou um código de barras foi decodificado. Uma carteira, portanto, é cobrada pelo segundo ou pelo terceiro caso. Uma foto ruim demais para render cinco campos e sem código de barras é gratuita. A regra de cobrança traz a definição completa.
O que o OCR não diz
Ler uma carteira e verificá-la são trabalhos diferentes. O doc.cheap lê o que está impresso no cartão e, no verso, o código de barras. No cenário só de reconhecimento, authenticity.overall é not_checked, então ele não diz se o cartão é autêntico, se foi suspenso ou se a pessoa que o segura é a titular. Se o seu fluxo precisa de alguma dessas coisas, são etapas separadas, com ferramentas e registros feitos para isso.
Experimente
A chave pública de sandbox não precisa de conta. Ao se cadastrar, você ganha 100 reconhecimentos grátis todo mês na sua própria chave, o suficiente para montar o fluxo inteiro – frente, verso e as suas próprias verificações. Se você está escolhendo um fornecedor, a comparação de APIs de OCR de passaporte coloca os preços publicados lado a lado, e o guia da carteira de motorista traz a chamada em curl, JavaScript e Python, com dicas para fotografar um cartão brilhante.
Uma pergunta para você: quando uma carteira não tem zona, qual verificação pega mais leituras ruins no seu fluxo – as datas, o código de barras no verso ou outra coisa? Conte para a gente nos comentários abaixo.