Dígito verificador ID Hong Kong
O corpo A123456 recebe o dígito verificador 3, então o número completo fica A123456(3). Calcule esse último caractere ou confira um número inteiro antes de salvar um cadastro ou aceitar um formulário, e pegue erros como A123456(4). Grátis no seu navegador.
- Grátis
- Funciona no seu navegador
- Sem cadastro
- Seus dados não saem do seu aparelho
Executar grátis
Exemplo resolvido
- HKID
- A123456
- Modo de cálculo
- Compute
- Entrada
- A123456
- Dígito verificador
- 3
- Com dígito verificador
- A1234563
- Formatado
- A123456(3)
Os números do documento de identidade de Hong Kong terminam com um único caractere de verificação derivado de uma ponderação fixa módulo onze sobre as letras do prefixo e os seis dígitos do corpo. Esse caractere final é um dígito de zero a nove ou a letra A, e costuma ser impresso entre parênteses após o corpo — por exemplo A123456(3) ou G123456(A). Uma letra digitada errada, um dígito do corpo trocado ou um erro de OCR em um formulário frequentemente quebram a soma de verificação, de modo que validar o dígito verificador antes de salvar um perfil, aceitar um documento KYC ou importar uma lista detecta muitos erros de digitação cedo. Esta capacidade calcula o dígito verificador do ID de Hong Kong para um prefixo de uma ou duas letras mais seis dígitos, ou valida um número completo que já inclui o caractere final, e reporta entrada inválida em vez de remover pontuação em silêncio.
O que é o dígito verificador do ID de Hong Kong e como funcionam os pesos módulo onze
Um número de cartão de identidade permanente ou não permanente de Hong Kong é formado por um ou dois caracteres alfabéticos de prefixo, seis dígitos decimais que formam o corpo e um caractere de verificação final. O esquema do Departamento de Imigração mapeia cada letra para um número (A vale dez, B onze, até Z que vale trinta e cinco) e, quando o cartão usa prefixo de uma só letra, insere um espaço inicial com valor trinta e seis para que cada soma cubra sempre oito posições.
Esses oito valores são multiplicados pelos pesos fixos nove, oito, sete, seis, cinco, quatro, três e dois da esquerda para a direita. Os produtos são somados, o total é reduzido módulo onze e onze menos esse resto torna-se a verificação: se o resultado for onze o caractere impresso é zero; se for dez o caractere impresso é a letra A; caso contrário o resultado é o próprio dígito decimal de verificação. Quando alguém digita A123456(3) como A123456(4), a soma ponderada deixa de coincidir e a validação falha.
A mesma regra captura muitas substituições de um só caractere em integrações de RH, pacotes KYC bancários, formulários de telecomunicações e arquivos de matrícula escolar onde operadores redigitam números a partir de cartões de plástico ou digitalizações de passaporte. Esta ferramenta implementa essa ponderação pública sobre letras maiúsculas normalizadas e dígitos após o tratamento opcional de espaços e parênteses.
Não consulta nenhuma base de dados governamental, não prova que uma pessoa existe nem decodifica idade ou residência a partir do corpo — apenas que a cadeia de caracteres é consistente sob o algoritmo de verificação publicado. Em comparação com Luhn módulo dez usado em cartões de pagamento, o esquema HKID usa valores de letras e módulo onze com o sentinela A, de modo que você não deve reutilizar um validador Luhn em campos de ID de Hong Kong.
Em comparação com ajudantes do ID de residente da China continental ou de Macau, a regra de Hong Kong é específica deste prefixo de uma ou duas letras, corpo de seis dígitos e vetor de pesos de oito posições. Saber qual esquema você precisa evita falsa confiança quando uma utilidade geral de dígito verificador aceita uma cadeia de dígitos que não é um número de cartão de identidade de Hong Kong bem formado.
Onde os dígitos verificadores do ID de Hong Kong se encaixam em KYC, RH e fluxos comerciais
Fluxos de conhecimento do cliente e abertura de contas em bancos, corretoras e apps fintech armazenam um número de cartão de identidade de Hong Kong em cada perfil de residente elegível; um único dígito digitado errado na integração pode enviar documentos de conformidade à pessoa errada ou falhar em um pareamento posterior com um scan.
Empregadores, escolas e operadoras de telecomunicações associam um HKID a cada pessoa em importações CSV em lote; erros de corpo deslocados em um e parênteses ausentes são comuns ao redigitar a partir de papel, e um dígito verificador os captura antes da primeira folha de pagamento ou ativação de SIM.
Equipes de produto que já expõem ferramentas gerais de verificação Luhn ou ISO 7064 ainda devem usar esta capacidade específica de Hong Kong para campos HKID, para que o mapeamento de letras, o preenchimento com espaço de prefixo de uma letra, os limites de comprimento e o formato de A como dez combinem com o domínio.
Não trate um dígito verificador de ID de Hong Kong correto como prova de que a pessoa está corretamente identificada, possui cartão válido, é residente ou aparece em algum registro oficial — apenas prova que a cadeia de caracteres é consistente sob o algoritmo de verificação módulo onze do cartão de identidade de Hong Kong.
Casos de uso
Auditar colunas de ID de Hong Kong em arquivos de parceiros e folha de pagamento
Valide em lote cada HKID de uma importação CSV e coloque em quarentena as linhas cujo caractere de verificação não coincida mais com o valor esperado recalculado.
Perguntas frequentes
O que acontece com comprimento, letras ou pontuação incorretos?
Forneça 1–2 letras e seis dígitos, opcionalmente um controle 0–9 ou A. Compute precisa só do corpo; validate precisa do ID completo. Tarefas de validação com falha não são cobradas.
A ferramenta de dígito verificador do ID de Hong Kong é grátis?
A ferramenta do navegador é grátis e roda localmente.
Como é calculado o dígito verificador do HKID?
As letras viram números (A vale 10 e Z vale 35) e, quando há uma só letra, entra antes um espaço que vale 36. Os oito valores são multiplicados por 9 até 2 e somados; 11 menos o resto da divisão por 11 dá o verificador: 10 vira A e 11 vira 0.
Por que alguns números de Hong Kong terminam em A?
Porque, quando o cálculo dá 10, o caractere verificador é escrito com a letra A em vez de um número de dois dígitos, como em G123456(A). Qualquer outro resultado aparece como um dígito.
Um dígito verificador correto prova que a carteira é verdadeira?
Não. Ele só mostra que os caracteres estão coerentes com a regra de verificação publicada. Nenhum banco de dados oficial é consultado, e a ferramenta não revela idade, residência nem se a pessoa existe.
Ferramentas relacionadas
Para desenvolvedores — acesso via API
Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.
Endpoint
Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.
Chame do seu código
curl -X POST https://api.kit.forhosting.com/enc/hkid \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"hkid":"A123456"}'const res = await fetch("https://api.kit.forhosting.com/enc/hkid", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"hkid": "A123456"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/enc/hkid",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"hkid": "A123456"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/enc/hkid", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"hkid":"A123456"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"hkid":"A123456"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/enc/hkid", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemplo de requisição
{
"hkid": "A123456"
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "enc.hkid",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.
Preço
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
Erros
| HTTP | Código | O que significa |
|---|---|---|
401 | unauthorized | Token ausente ou inválido. Confira o header Authorization. |
402 | insufficient_balance | Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo. |
404 | unknown_type | Esse tipo de tarefa não existe. Confira o campo type no catálogo. |
429 | rate_limited | Muitas requisições em pouco tempo. Espere um instante e tente de novo. |
Notas técnicas
Use grátis no navegador ou chame a API do KIT ao preço publicado; ambos os caminhos executam a mesma aritmética determinística sem consulta de rede e sem registro de titulares reais.
Como calcular um dígito verificador ou validar um ID de Hong Kong completo
Envie um campo hkid que contenha uma ou duas letras de A a Z, seis dígitos de zero a nove e, opcionalmente, um caractere de verificação final de zero a nove ou A. O modo validate espera um número completo incluindo o caractere de verificação final, seja entre parênteses (A123456(3), G123456(A)) ou anexado como caractere final (A1234563, G123456A). Strings vazias, hkid ausente, valores de mode inválidos, contagens erradas de letras ou dígitos e pedidos compute que já incluem um caractere de verificação falham antes de qualquer soma ponderada e não são cobrados. Prefira compute quando montar uma string de ID a partir de um prefixo conhecido e um corpo de seis dígitos; prefira validate quando um usuário, arquivo de parceiro ou cartão digitalizado fornecer um número completo e você precisar de um filtro booleano antes de uma consulta a dados mestres internos. Espaços ao redor do valor são removidos; outra pontuação, minúsculas (normalizadas para maiúsculas), parênteses duplos ou símbolos embutidos são rejeitados como entrada malformada com invalid_input para que você nunca aceite um valor limpo em silêncio. O modo compute é o padrão: forneça apenas o corpo sem o caractere de verificação (por exemplo A123456, G123456 ou XA123456), e o motor devolve check_digit como string de um caractere, with_check como o corpo mais esse caractere sem parênteses, e formatted na forma familiar BODY(CHECK) usada em cartões e formulários. A resposta indica valid true quando o caractere de verificação recalculado coincide com o fornecido, e sempre inclui check_digit, expected_check_digit, body sem a verificação, with_check e formatted para exibição consistente. Como o caminho é parse puro sem relógio, fonte aleatória ou rede, a mesma entrada sempre produz o mesmo JSON na ferramenta gratuita do navegador e na API. A US$ 0,002 por pedido bem-sucedido você pode controlar importações em massa de listas, formulários de integração e jobs ETL sem negociar um nível personalizado.
Onde os dígitos verificadores do ID de Hong Kong se encaixam em KYC, RH e fluxos comerciais
O modo validate na entrada bloqueia o salvamento quando valid é false e pode mostrar expected_check_digit para que o atendente corrija o formulário antes de gravar o registro.
Casos de integração
Controlar campos HKID em formulários de integração e KYC
Quando um usuário envia um ID de Hong Kong completo, chame o modo validate e bloqueie o salvamento quando valid for false, mostrando expected_check_digit para ajudar a corrigir um único erro de digitação antes de gravar o perfil.
Calcular dígitos verificadores ao completar strings de ID
A partir de um prefixo de letras e um corpo de seis dígitos, chame o modo compute e armazene with_check ou formatted para que cada nova string tipo HKID carregue o caractere final correto antes de imprimir ou exportar.
Perguntas técnicas
O que é o dígito verificador do ID de Hong Kong?
É um único caractere final (0–9 ou A) calculado com pesos 9..2 sobre valores de letras (A=10..Z=35, espaço inicial=36 em prefixos de uma letra) e seis dígitos do corpo, depois módulo 11, de modo que a maioria dos erros de um caractere quebra a soma de verificação.
Como calcular um dígito verificador de ID de Hong Kong com esta API?
Faça POST com hkid definido apenas para o corpo (uma ou duas letras mais seis dígitos, p. ex. A123456) e mode compute (ou omita mode). A resposta inclui check_digit, with_check e formatted como BODY(CHECK).
Como validar um ID de Hong Kong completo?
Faça POST com o número completo incluindo o caractere de verificação (p. ex. A123456(3) ou G123456(A)) e mode validate. A resposta inclui valid, check_digit, expected_check_digit, body e formatted.