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_class ou permit_class, issue_date, expiry_date, address e authority. 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 categoria other.
  • Use id como chave, não name. Uma carteira impressa em dois alfabetos retorna uma entrada por idioma com o mesmo name; só o id é único.
  • document.expiry_date, is_expired e days_remaining sã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.

  1. Datas em ordem. birth_date antes de issue_date, issue_date no dia do scan ou antes, expiry_date depois de issue_date. Uma leitura que quebra essa ordem é um erro de leitura ou uma foto ruim.
  2. 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.
  3. 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_expired e days_remaining são null juntos, e o campo derivado days_to_expire também é null. Decida o que o seu fluxo faz nesse caso; não trate null sem querer nem como vencida nem como válida.
  4. A categoria, não só a existência. Se você precisa de alguém habilitado para carro, procure essa categoria em dl_class ou permit_class em vez de só verificar que existe uma carteira. O valor é texto impresso, como B, BE, então separe-o antes de comparar, e compare com as categorias que a sua própria jurisdição define.
  5. 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.
  6. Contra o que o usuário digitou. Compare holder.surname e holder.birth_date com o formulário que o seu usuário preencheu, normalizados do mesmo jeito.
  7. A confiança como sinal. Cada leitura traz uma faixa – high, medium ou low. Uma faixa low em 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.