Permita que as pessoas iniciem sessão com a identificação que já possuem.
Verifique pessoas com uma identidade eletrónica (eID) que já utilizam. Aceite MitID, BankID Suécia, Finnish Trust Network, Smart-ID e Mobile-ID num único fluxo, com o documento como alternativa quando necessário.
Confiado por mais de 3.000 organizações em todo o mundo.
MitIDDenmark · Danish Agency for Digital GovernmentAtivo
BankIDSweden · Finansiell ID-Teknik / bank consortiumAtivo
BankIDNorway · BankID BankAxept ASEm breve
VippsNorway · Vipps MobilePay / BankID NOEm breve
Buypass IDNorway · Buypass ASEm breve
itsmeBelgium, Luxembourg, Netherlands · Belgian Mobile IDEm breve
iDINNetherlands · Dutch banks (Currence iDIN)Em breve
Finnish Trust NetworkFinland · Finnish banks and mobile operators (FTN)Ativo
PersonalausweisGermany · Bundesministerium des Innern (eID)Em breve
Freja eIDSweden · Freja eID GroupEm breve
UAE PASSUnited Arab Emirates · UAE Digital Government AuthorityEm breve
gov.brBrazil · Governo Federal do BrasilEm breve
OneIDUnited Kingdom · OneID (UK bank-verified identity)Em breve
GOV.UK WalletUnited Kingdom · UK Government Digital ServiceEm breve
Smart-IDEstonia, Latvia, Lithuania, Belgium · SK ID SolutionsAtivo
Mobile-IDEstonia, Lithuania · SK ID Solutions with the national mobile operatorsAtivo
Bank iDCzechia · Bankovní identita, a.s.Em breve
MojeIDCzechia · CZ.NICEm breve
DiiaUkraine · Ministry of Digital Transformation of UkraineEm breve
FranceConnectFrance · DINUM (French state)Em breve
AuðkenniIceland · Auðkenni (Icelandic electronic ID)Em breve
ConnectIDAustralia · Australian Payments PlusEm breve
EUDI Wallet30 países da UE e EEE · The user's own member state; the issuer differs per country+26Em breve
Os estados distinguem a disponibilidade em produção dos testes de integração. A cobertura por país descreve a rota da carteira configurada, não uma verificação de identidade ao vivo concluída em todos os países. Nenhuma data de lançamento é prometida.
Estado da integração
Carteiras de identidade digital. Estado de implementação claro.
MitID, BankID Suécia, Finnish Trust Network, Smart-ID e Mobile-ID estão disponíveis. Escolha as carteiras aceites por país e deixe os utilizadores autenticarem-se com uma identidade elegível que já possuem. As restantes integrações listadas chegam em breve.
Como funciona
De um início de sessão com carteira a um utilizador verificado em quatro passos.
Passo 01 / 04
01
Crie o fluxo de trabalho
Na consola, selecione as carteiras disponíveis para cada país no seu ambiente. Escolha se um início de sessão cancelado ou falhado reverte para a captura de documentos ou é recusado.
Integre
Incorpore nativamente com os nossos SDKs Web, iOS, Android, React Native ou Flutter. Redirecione para uma página alojada. Ou simplesmente envie ao seu utilizador um link — por e-mail, SMS, WhatsApp, em qualquer lugar.
O utilizador passa pelo fluxo
Para Smart-ID, insira o código pessoal. Para Mobile-ID, insira o código pessoal e o número de telefone. Compare o código exibido pela Didit com o código no seu telemóvel e, em seguida, aprove no seu dispositivo. O seu PIN permanece no seu telemóvel.
Recebe os resultados
Webhooks assinados em tempo real mantêm a sua base de dados sincronizada no momento em que um utilizador é aprovado, recusado ou enviado para revisão. Consulte a API sob demanda. Ou abra a consola e leia os atributos assinados.
Criado para programadores · Criado contra fraude · Aberto por design
Seis funcionalidades. Uma lista de aceitação por país.
Uma carteira digital é um método de verificação de identidade, com o mesmo contrato de resultado da captura de documentos. O que muda é a evidência: uma assinatura do emissor em vez de uma fotografia.
Aceite as carteiras digitais que um país realmente usa.
Veja cada carteira, a cobertura por país, a autoridade emissora e a disponibilidade num só lugar. MitID, BankID Suécia, Finnish Trust Network, Smart-ID e Mobile-ID estão disponíveis; as integrações previstas aparecem marcadas como Em breve.
Catálogo de carteiras
Diretamente do catálogo de métodos
23
No catálogo
35
Países abrangidos
10
eIDAS alto
MitIDEm direto
BankIDEm direto
BankIDEm breve
VippsEm breve
Buypass IDEm breve
02 · Lista de aceitação
Selecione o que aceita. O utilizador escolhe.
Escolha quais carteiras disponíveis aceitar por país no seu workflow. O utilizador escolhe a partir desse conjunto. Uma carteira listada como "em breve" não pode ser ativada até que o catálogo no seu ambiente a marque como disponível.
Lista de aceitação para a Noruega
Sem controlos de ordenação em lado nenhum
BankIDEm breve
VippsEm breve
Buypass IDEm breve
EUDI WalletEm breve
Marcar é toda a configuração. O utilizador escolhe entre o que aceita, e a ordem no ecrã não tem significado. Cada carteira mantém o seu estado de catálogo até ficar ativa.
03 · A transição
Compare o código. Aprove no seu telemóvel.
A Smart-ID usa o seu código pessoal; a Mobile-ID também pede o seu número de telefone. A Didit exibe um código de comparação enquanto aprova o pedido no seu dispositivo. O seu PIN nunca é inserido na Didit. O cancelamento e a falha seguem a sua configuração de fallback de workflow.
A transição
Fluxo Smart-ID e Mobile-ID
1Insira o seu código pessoal
2Compare o código e aprove no seu telemóvel
3Regresse com atributos de identidade verificados
Sem carteira, cancelado ou falhouDocumento
04 · Atributos assinados
Leia os atributos assinados pelo emissor.
Nome, data de nascimento e o identificador nacional que a carteira digital expõe, mais a própria declaração assinada. Desmarque qualquer atributo opcional que não queira armazenar e este nunca será gravado na sessão.
Atributos assinados
MitID · Danish Agency for Digital Government
Full nameSempre
Date of birthSempre
CPR alias (pseudonymised)Sempre
Level of assurance reachedSempre
Signed assertionSempre
Assinatura do emissorVálido
05 · Garantia
Alcance o nível mais alto dos três níveis de garantia.
Um documento oferece garantia documental. Uma consulta de registo oferece uma correspondência de dados. Uma carteira digital oferece garantia criptográfica, porque o emissor assinou os atributos e a Didit verifica essa assinatura.
Níveis de garantia
Apenas para interfaces de administração
DocumentalCaptura de documento
Correspondência de dadosConsulta de registo
CriptográficoInício de sessão na carteira
Os utilizadores finais nunca veem um rótulo de garantia, um nome de origem ou um preço. Os seus revisores veem os três.
06 · Abrangência
Cobertura por país de cada carteira ativa.
Aceite MitID na Dinamarca, BankID na Suécia, Finnish Trust Network na Finlândia, Smart-ID na Estónia, Letónia, Lituânia e Bélgica, e Mobile-ID na Estónia e Lituânia. Os utilizadores autenticam-se com uma credencial elegível para a carteira escolhida.
Alcance no catálogo
Países com pelo menos uma carteira
35
Países
30
Abrangido pela Carteira EUDI
A cobertura segue o catálogo país a país. Uma bandeira aqui significa que uma carteira está listada para esse país, não que esteja ativa.
Integrar
Uma chamada. Um resultado assinado de volta.
Crie a sessão, envie o utilizador para ela e verifique o webhook assinado quando o resultado chegar. A carteira digital com a qual o utilizador iniciou sessão é devolvida no resultado.
// Your endpoint receives a signed payloadconst crypto = require("node:crypto"); // ESM: import crypto from "node:crypto"// X-Signature-V2 = HMAC over the canonical JSON, never the raw bytes. Match the sender byte for// byte: keys sorted by code point, integers digit for digit, floats in Python's repr.class Num { constructor(src) { this.src = src; } } // a number as written on the wire, not a doubleconst num = (s) => { if (/^-?\d+$/.test(s)) return BigInt(s).toString(); const n = +s; // ints stay exactif (Number.isInteger(n)) return BigInt(n).toString(); const [m, e] = n.toExponential().split("e"); // 27.0 -> 27return +e >= -4 ? String(n) : `${m}e-${String(-e).padStart(2, "0")}`; }; // 1e-05, not 0.00001const byCodePoint = (a, b) => Buffer.compare(Buffer.from(a), Buffer.from(b)); // UTF-8 order = Python'sconst canon = (v) => Array.isArray(v) ? `[${v.map(canon)}]` : v instanceof Num ? num(v.src)
: v && typeof v === "object" ? `{${Object.keys(v).sort(byCodePoint).map((k) => `${JSON.stringify(k)}:${canon(v[k])}`)}}`
: JSON.stringify(v);
// Read the body as text: express.json() would round 1000000000000000129 to a double first.// Register this route ABOVE any global app.use(express.json()): the first parser to run// consumes the stream, and a body it already parsed has lost the digits the signature covers.
app.post("/webhooks/didit", express.text({ type: "application/json" }), (req, res) => {
const exact = JSON.parse(req.body, (k, v, c) => typeof v === "number" ? new Num(c.source) : v); // Node 21+const body = JSON.parse(req.body);
const mac = crypto.createHmac("sha256", SECRET).update(canon(exact), "utf8").digest("hex");
const sig = Buffer.from(String(req.headers["x-signature-v2"] ?? ""));
// Freshness comes from the signed body timestamp; the header alone is unsigned and replayable.const ts = body.timestamp, fresh = String(ts) === req.headers["x-timestamp"]
&& Math.abs(Date.now() / 1000 - ts) <= 300;
if (!fresh || sig.length !== mac.length
|| !crypto.timingSafeEqual(sig, Buffer.from(mac))) return res.sendStatus(401);
const { status, decision } = body;
// One entry per ID Verification node; pick yours by node_id when you run several.const [idv] = decision?.id_verifications ?? [];
// idv.verification_method: "document" | "id_lookup" | "wallet"
res.sendStatus(200);
});
Implemente o início de sessão com carteira digital num só prompt.
Cole o bloco abaixo no Claude Code, Cursor, Codex, Devin, Aider ou Replit Agent. Preencha o placeholder my_stack com o seu framework, linguagem e caso de uso. O agente provisiona a Didit, aceita as carteiras digitais por país, configura o webhook e implementa.
didit-integration-prompt.md
# Didit digital ID wallets — integrate in 5 minutes
You are adding digital ID wallet sign-in to my_stack. The user signs in with a
government or bank digital identity and the wallet returns signed attributes.
Every URL, header, and enum value below is canonical — do not paraphrase or
"improve" them.
## 1. Provision an account
- Sign up: https://business.didit.me (no credit card required).
- Grab the API key for your application from the console.
## 2. Read the methods catalog first
Wallet availability is server-driven per country. Never hard-code a wallet list.
Read the catalog one of these ways:
- Business Console: your application -> Workflows -> the ID Verification
step -> Countries -> "Wallets accepted". Coming-soon wallets are listed
but cannot be switched on. https://docs.didit.me/console/id-verification-methods
- Didit MCP server (https://mcp.didit.me/mcp), tool
didit_workflow_get_id_verification_methods_catalog; pass country as ISO
3166-1 alpha-3 to narrow it. The MCP server signs in with "Log in with
Didit" (OAuth). It does not accept the x-api-key.
https://docs.didit.me/integration/mcp/tools
- Public coverage table (no sign-in, read-only):
https://docs.didit.me/core-technology/id-verification/digital-id-wallets#supported-wallets
If your code holds only an API key, it cannot read the catalog itself: use the
wallet ids listed in this prompt, and treat the answer of the workflow save as
the check. A live application answers 400 for a wallet that is not available
in that country ("<wallet> is not offered in <ISO3>", "unknown wallet").
The catalog gives you, per wallet id: the display name, the countries it
covers, the issuing authority, the level of assurance, the availability state,
and the attributes it returns. When this prompt was generated it marked these
available:
- MitID: wallet id mitid, country keys DNK
- BankID: wallet id bankid_se, country keys SWE
- Finnish Trust Network: wallet id ftn, country keys FIN
- Smart-ID: wallet id smart_id, country keys EST, LVA, LTU, BEL
- Mobile-ID: wallet id mobile_id, country keys EST, LTU
Finnish Trust Network has its own integration guide:
https://docs.didit.me/core-technology/id-verification/finnish-trust-network
iDIN and other wallets remain coming soon until the catalog in
your environment marks them available. Check it; do not hard-code a date.
## 3. Create a workflow with the ID Verification (OCR) feature
POST https://verification.didit.me/v3/workflows/
-H "x-api-key: <your-api-key>"
-H "Content-Type: application/json"
The ID Verification feature's enum value is OCR (UPPERCASE — strict enum;
there is no ID_VERIFICATION alias and the API rejects it). Wallets are its
wallet method, accepted per country under config.methods on that same
feature entry, in the same request. Keys are ISO 3166-1 alpha-3.
{
"workflow_label": "Wallet onboarding",
"features": [
{
"feature": "OCR",
"config": {
"methods": {
"DNK": {
"document": { "enabled": true },
"wallet": {
"enabled": true,
"providers": ["mitid"],
"on_failure": "fallback_to_document"
}
},
"FIN": {
"document": { "enabled": true },
"wallet": {
"enabled": true,
"providers": ["ftn"],
"on_failure": "fallback_to_document"
}
}
}
}
}
]
}
Response: 201. The workflow id is uuid (workflow_id carries the same value);
the workflow is published straight away. Create it once and keep the id:
every call to this endpoint makes a new workflow.
is_desktop_allowed defaults to false: on a desktop browser the hosted flow
then shows a QR code to continue on a phone. Add "is_desktop_allowed": true
next to workflow_label to let people finish on desktop.
Use that id as workflow_id in step 4. The ID Verification node id of a
workflow made by this call is "ocr".
Rules that the API enforces:
- providers is an accept-list, not a ranking. Order carries no meaning and
the end user picks
- on_failure is either fallback_to_document or decline. It covers all three
cases: no wallet, cancelled, sign-in failed
- a wallet id the catalog does not mark available for that country is
rejected, and the rejection fails the whole save — including any lookup
configuration next to it. For unavailable wallets, keep wallet.enabled
false (or omit the wallet block) so the save succeeds. A sandbox
application accepts coming-soon wallets, so this only shows on live
- unknown wallet ids already saved on a workflow are preserved untouched, so
a config written by a newer console version is never silently dropped
- a country with no method enabled is rejected at publish time
## 4. Create a session
POST https://verification.didit.me/v3/session/
-H "x-api-key: <your-api-key>"
-H "Content-Type: application/json"
-d '{ "workflow_id": "<id from step 3>", "vendor_data": "<your user id>" }'
Response: 201 with session_id, session_token, url and status "Not Started".
Redirect the user to url (hosted flow) or open it in the Web, iOS, Android,
React Native or Flutter SDK. The field is named url on this response.
One unfinished session exists per workflow_id and vendor_data pair: calling
create again with the same pair answers 201 again with that same session.
Didit shows the accepted wallets for the user's country with their brand marks,
hands off to the wallet, and waits for the signed assertion to come back.
## 5. Webhooks
Register a destination in the console (API & Webhooks), or over the API:
POST https://verification.didit.me/v3/webhook/destinations/
-H "x-api-key: <your-api-key>"
-H "Content-Type: application/json"
-d '{
"label": "Verification webhooks",
"url": "https://<your-public-host>/webhooks/didit",
"webhook_version": "v3",
"subscribed_events": ["status.updated", "data.updated"]
}'
label, url and subscribed_events are required. url must be a public HTTPS
address: Didit does not deliver to localhost or private addresses. Response:
201 with uuid and secret_shared_key. Store secret_shared_key as the webhook
secret (DIDIT_WEBHOOK_SECRET); it is unique to this destination. Remove a
destination with DELETE /v3/webhook/destinations/{uuid}/ (204).
What arrives:
- webhook_type is "status.updated" (the session changed status) or
"data.updated" (verification data was corrected after the fact)
- a destination receives the events of every session of the application,
so filter on workflow_id or vendor_data when several flows share it
- creating a session already sends status.updated with status
"Not Started". The decision key is present only when status is Approved,
Declined, In Review or Abandoned.
Verify every delivery:
Header: X-Signature-V2 (NOT X-Signature, NOT X-Signature-Simple)
Algorithm: HMAC-SHA256, hex digest, over the CANONICAL JSON of the payload
— the sender's Python json.dumps(sort_keys=True,
separators=(",", ":"), ensure_ascii=False) after whole-valued
floats become ints. Reproduce those bytes EXACTLY; do NOT
"parse, sort keys, JSON.stringify", which fails in four ways:
numbers come from the wire TEXT, never from parsed doubles
(read the body with express.text, not express.json(),
registered ABOVE any global app.use(express.json()), and
re-emit integers through BigInt(source) — JSON.parse rounds
1000000000000000129); floats use Python's repr (1e-05, not
0.00001; 27.0 becomes 27); keys sort by Unicode CODE POINT as
strings ("10" before "2", U+FF21 before U+1F642, which
JavaScript's default .sort() reverses); and the bytes come
straight from the sorted entries, never from a rebuilt object.
Do NOT hash the raw request bytes — that is the v1
X-Signature algorithm and fails for V2 whenever whitespace or
key order differs from the canonical form.
Freshness: the signed body field timestamp is the dispatch time (Unix
seconds, refreshed on every retry). Reject when
abs(now - timestamp) > 300 seconds, and reject when the
X-Timestamp header does not equal it. The header is not
covered by the signature, so it must never be the only replay
check: a captured delivery replays with just that header
refreshed.
Idempotency: event_id is the same on every retry of one event, so store it
and skip a delivery you already processed. One session can
still send the same status under two event ids, and the
console's Try Webhook test deliveries carry no event_id, so
also make the handler safe to run twice for one
(session_id, status, webhook_type).
Compare: constant-time (crypto.timingSafeEqual)
Reference handler (Express). Keep the verification lines as written.
The handler is a fragment. Put this above it and app.listen(process.env.PORT)
below it. It needs Express and Node 21 or newer (an older Node rejects
every delivery). It expects a JSON body: answer 400 yourself if you accept
anything else on this route, and refuse to start without the secret.
const express = require("express");
const app = express();
const SECRET = process.env.DIDIT_WEBHOOK_SECRET; // secret_shared_key of the destination
// Your endpoint receives a signed payload
const crypto = require("node:crypto"); // ESM: import crypto from "node:crypto"
// X-Signature-V2 = HMAC over the canonical JSON, never the raw bytes. Match the sender byte for
// byte: keys sorted by code point, integers digit for digit, floats in Python's repr.
class Num { constructor(src) { this.src = src; } } // a number as written on the wire, not a double
const num = (s) => { if (/^-?\d+$/.test(s)) return BigInt(s).toString(); const n = +s; // ints stay exact
if (Number.isInteger(n)) return BigInt(n).toString(); const [m, e] = n.toExponential().split("e"); // 27.0 -> 27
return +e >= -4 ? String(n) : `${m}e-${String(-e).padStart(2, "0")}`; }; // 1e-05, not 0.00001
const byCodePoint = (a, b) => Buffer.compare(Buffer.from(a), Buffer.from(b)); // UTF-8 order = Python's
const canon = (v) => Array.isArray(v) ? `[${v.map(canon)}]` : v instanceof Num ? num(v.src)
: v && typeof v === "object" ? `{${Object.keys(v).sort(byCodePoint).map((k) => `${JSON.stringify(k)}:${canon(v[k])}`)}}`
: JSON.stringify(v);
// Read the body as text: express.json() would round 1000000000000000129 to a double first.
// Register this route ABOVE any global app.use(express.json()): the first parser to run
// consumes the stream, and a body it already parsed has lost the digits the signature covers.
app.post("/webhooks/didit", express.text({ type: "application/json" }), (req, res) => {
const exact = JSON.parse(req.body, (k, v, c) => typeof v === "number" ? new Num(c.source) : v); // Node 21+
const body = JSON.parse(req.body);
const mac = crypto.createHmac("sha256", SECRET).update(canon(exact), "utf8").digest("hex");
const sig = Buffer.from(String(req.headers["x-signature-v2"] ?? ""));
// Freshness comes from the signed body timestamp; the header alone is unsigned and replayable.
const ts = body.timestamp, fresh = String(ts) === req.headers["x-timestamp"]
&& Math.abs(Date.now() / 1000 - ts) <= 300;
if (!fresh || sig.length !== mac.length
|| !crypto.timingSafeEqual(sig, Buffer.from(mac))) return res.sendStatus(401);
const { status, decision } = body;
// One entry per ID Verification node; pick yours by node_id when you run several.
const [idv] = decision?.id_verifications ?? [];
// idv.verification_method: "document" | "id_lookup" | "wallet"
res.sendStatus(200);
});
Body fields you will use: event_id, session_id, status, webhook_type,
workflow_id, vendor_data, timestamp, decision.
Status values (exact strings): Not Started, In Progress, Approved, Declined,
In Review, Resubmitted, Expired, Abandoned, Kyc Expired. Awaiting User only
appears on business verification sessions.
## 6. Reading the result
The same V3 decision reaches you two ways:
- webhook body: body.decision.id_verifications[]
- GET https://verification.didit.me/v3/session/{session_id}/decision/
-H "x-api-key: <your-api-key>"
This response IS the decision object. Read id_verifications at the top
level: there is no decision wrapper here.
Until the user finishes the ID step, status is "Not Started" or "In Progress"
and id_verifications is null, not an empty array. Guard for it.
The decision is the V3 shape: every feature result is a plural array with one
entry per workflow node. ID Verification results live in
id_verifications[]: there is no singular kyc (that is the V2 shape) and no
id_verification. The decision's features list names the step
ID_VERIFICATION, while the workflow body takes OCR. Select your entry by node_id (the
id of your ID Verification node in the workflow graph); with a single ID step,
take index 0. Each entry carries, next to the document fields:
verification_method "document" | "id_lookup" | "wallet"
assurance "documentary" | "data_match" | "cryptographic"
wallet_provider the catalog wallet id the user signed in with; null
on document and id_lookup entries
wallet_verification provider, provider_name, issuing_authority,
issuing_country, credential_type, level_of_assurance
(low | substantial | high), verified_at,
signature_valid, attributes (what the wallet shared),
portrait when the wallet shares one; null otherwise
fallback_from { method, reason, action } when the wallet sign-in failed
and on_failure declined the session; otherwise
null. After a document fallback that succeeds the
entry reads verification_method "document" with
fallback_from null
A wallet entry that succeeds is assurance cryptographic: an identity provider
authenticated the person and signed the attributes. The normalised full_name
and date_of_birth sit on the entry itself; attributes holds the wallet's own
claims. On a live application, check wallet_verification.signature_valid
before you trust attributes.
Field-by-field reference: https://docs.didit.me/reference/data-models#id-verification
## 7. Billing
- published customer prices in USD per completed wallet verification:
- MitID personal: $0.25; production availability: Available
- BankID Sweden: $0.20; production availability: Available
- Finnish Trust Network: $0.25; production availability: Available
- Smart-ID: $0.20; production availability: Available
- Mobile-ID: $0.20; production availability: Available
- BankID Norway High: $0.35; production availability: Coming soon
- Vipps Plus: $0.25; production availability: Coming soon
- Buypass ID: Coming soon; production availability: Coming soon
- itsme: Coming soon; production availability: Coming soon
- iDIN full identification: $0.85; production availability: Coming soon
- Personalausweis Profile 2: $0.45; production availability: Coming soon
- Freja eID: $0.25; production availability: Coming soon
- UAE PASS: Coming soon; production availability: Coming soon
- gov.br: Coming soon; production availability: Coming soon
- OneID: $2.50; production availability: Coming soon
- GOV.UK Wallet: Coming soon; production availability: Coming soon
- Bank iD: Coming soon; production availability: Coming soon
- MojeID: Coming soon; production availability: Coming soon
- Diia: Coming soon; production availability: Coming soon
- FranceConnect: Coming soon; production availability: Coming soon
- Auðkenni: Coming soon; production availability: Coming soon
- ConnectID: Coming soon; production availability: Coming soon
- EUDI Wallet: Coming soon; production availability: Coming soon
- Estonian ID-card: $0.55; production availability: Coming soon
- eParaksts mobile: $0.55; production availability: Coming soon
- an announced price does not enable a wallet; check the live workflow catalog
- wallet checks are outside the document free tier; other checks are billed separately
- full pricing: https://docs.didit.me/core-technology/id-verification/digital-id-wallets#pricing
- document capture bills its own price when the user falls back
## 8. Hard rules — do not change
- base URL for v3 endpoints: verification.didit.me
- auth header: x-api-key (lowercase, hyphenated)
- webhook headers: X-Signature-V2 plus X-Timestamp; canonical JSON, never
raw bytes; freshness from the signed body timestamp
- feature enum: OCR (uppercase) — the ID Verification feature; per-country
methods go under its config.methods
- method keys: document, id_lookup, wallet (lowercase, snake_case)
- wallet ids come from the catalog verbatim, lowercase, snake_case
- country keys: ISO 3166-1 alpha-3, uppercase
- result path: decision.id_verifications[] in the webhook body and
id_verifications[] on the GET decision response, never kyc
## 9. Verify your integration
Sandbox (an application in sandbox mode: nothing is billed and no real eID is
called). https://docs.didit.me/integration/sandbox-testing
- a sandbox application can enable every wallet in the catalog, the
coming-soon ones included. A workflow that saves in sandbox can still be
refused on a live application, so only use wallets marked available.
- open the session url, pick the wallet and confirm: the default approve
scenario simulates the sign-in. The entry then has verification_method
"wallet", assurance "cryptographic" and wallet_provider set, and the
normalised full_name and date_of_birth are filled. But
wallet_verification.signature_valid and level_of_assurance are null and
attributes is { "sandbox": true }: no real credential was checked.
Assert signature_valid === true and the level of assurance only against
a live application.
- to exercise on_failure, create the session with
"sandbox_scenario": "wallet_cancelled" (also wallet_timeout and
wallet_provider_error). The wallet sign-in then fails and the flow moves
to document capture or declines, as on_failure says. A fallback that
ends in an approved document reads verification_method "document".
- POST /v3/session/{session_id}/simulate/ forces a final status but writes
no id_verifications entry, so it cannot stand in for a sign-in.
Checks:
- create the workflow, create a session, and read its decision: expect 201,
201 with url, and 200 with status "Not Started"
- run one session per accepted wallet in sandbox through the hosted flow
- assert the id_verifications[] entry for your node has verification_method
wallet and wallet_provider set to the wallet you picked
- run one session with sandbox_scenario "wallet_cancelled" and assert your
on_failure setting actually fires
- on a live application, assert wallet_verification.signature_valid is true
- assert your webhook accepts a correctly signed payload with reordered
keys, whitespace and integer-like metadata keys ("10" before "2"), and
rejects a wrong X-Signature-V2, a payload whose signed timestamp is older
than 300 seconds, and that same stale payload with only the X-Timestamp
header refreshed
Docs: https://docs.didit.me/integration/integration-prompt
Conformidade desde a conceção
Abra um novo país com um clique. Nós fazemos o trabalho difícil.
Abrimos as subsidiárias locais, garantimos as licenças, realizamos os testes de penetração, obtemos as certificações e alinhamos com cada nova regulamentação. Para lançar verificações num novo país, basta ativar um botão. Mais de 220 países ativos, auditados e testados trimestralmente, o único fornecedor de identidade que um governo de um estado-membro da UE formalmente considerou mais seguro do que a verificação presencial.
Captura de documentos, quando um utilizador recorre a ela
Preços e disponibilidade da carteira de identidade digital
Os preços abaixo são em USD por verificação de carteira concluída. Cobrem o produto de identidade nomeado; outras verificações de fluxo de trabalho e fallback de documentos são faturados separadamente. As 500 verificações de documentos mensais gratuitas não cobrem carteiras. Um preço anunciado não significa que uma carteira esteja ativa: a disponibilidade é mostrada separadamente. Carteiras disponíveis sem uma taxa publicada mostram "Sob consulta"; carteiras planeadas sem uma taxa publicada mostram "Em breve". As carteiras de identidade verificam pessoas; a análise de carteiras de criptomoedas é um produto separado.
Disponível significa ativado em produção. Em breve significa que ainda não está ativado em produção, mesmo que os testes de integração já tenham começado. As carteiras disponíveis aparecem primeiro.
O ConnectID (Austrália), o Cartão de Cidadão da Estónia (Estónia) e o eParaksts mobile (Letónia) estão integrados para testes em sandbox. Consulte a tabela para ver o preço publicado e a disponibilidade em produção de cada wallet.
Preços e disponibilidade da carteira de identidade digital
Carteira de identidade
USD / verificação concluída
País / região
Disponibilidade em produção
MitID personal
0,25 US$
Denmark
Disponível
BankID Sweden
0,20 US$
Sweden
Disponível
Finnish Trust Network
0,25 US$
Finland
Disponível
Smart-ID
0,20 US$
Estonia
Latvia
Lithuania
Belgium
Disponível
Mobile-ID
0,20 US$
Estonia
Lithuania
Disponível
BankID Norway High
0,35 US$
Norway
Brevemente
Vipps Plus
0,25 US$
Norway
Brevemente
Buypass ID
Brevemente
Norway
Brevemente
itsme
Brevemente
Belgium
Luxembourg
Netherlands
Brevemente
iDIN full identification
0,85 US$
Netherlands
Brevemente
Personalausweis Profile 2
0,45 US$
Germany
Brevemente
Freja eID
0,25 US$
Sweden
Brevemente
UAE PASS
Brevemente
United Arab Emirates
Brevemente
gov.br
Brevemente
Brazil
Brevemente
OneID
2,50 US$
United Kingdom
Brevemente
GOV.UK Wallet
Brevemente
United Kingdom
Brevemente
Bank iD
Brevemente
Czechia
Brevemente
MojeID
Brevemente
Czechia
Brevemente
Diia
Brevemente
Ukraine
Brevemente
FranceConnect
Brevemente
France
Brevemente
Auðkenni
Brevemente
Iceland
Brevemente
ConnectID
Brevemente
Australia
Brevemente
EUDI Wallet
Brevemente
Austria
Belgium
Bulgaria
Croatia
Cyprus
Czechia
Denmark
Estonia
Finland
France
Germany
Greece
Hungary
Ireland
Italy
Latvia
Lithuania
Luxembourg
Malta
Netherlands
Poland
Portugal
Romania
Slovakia
Slovenia
Spain
Sweden
Iceland
Liechtenstein
Norway
Brevemente
Estonian ID-card
0,55 US$
Estonia
Brevemente
eParaksts mobile
0,55 US$
Latvia
Brevemente
Três níveis, uma tabela de preços
Comece grátis. Pague à medida que usa. Escale para Enterprise.
500 verificações gratuitas todos os meses, para sempre. Depois, pague apenas quando um módulo for executado. Contratos personalizados, residência de dados e acordos de nível de serviço (SLAs) no plano Enterprise.
Grátis
$0/ mês · sem cartão
Para construir, testar e para os seus primeiros utilizadores.
Tudo o que precisa para começar:
500 verificações KYC completas por mês
ID, prova de vida, correspondência facial, dispositivo e IP
Mais de 200 sinais de fraude, blocklist, duplicados
KYC reutilizável em toda a rede Didit
Construtor de fluxos de trabalho, gestão de casos, SDKs
Apoio de IAAgente de IA na consola, documentação e comunidade.