Saltar para o conteúdo principal
Didit angaria 7,5 milhões de dólares para construir a infraestrutura para identidade e fraude
Didit
Carteiras de identificação digital

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.

Apoiado por
Y CombinatorRobinhood Ventures
Firecrawl
Slash
Crnogorski Telekom
UCSF Neuroscape
Bit2Me

Confiado por mais de 3.000 organizações em todo o mundo.

  • MitIDDenmark · Danish Agency for Digital GovernmentDenmarkAtivo
  • BankIDSweden · Finansiell ID-Teknik / bank consortiumSwedenAtivo
  • BankIDNorway · BankID BankAxept ASNorwayEm breve
  • VippsNorway · Vipps MobilePay / BankID NONorwayEm breve
  • Buypass IDNorway · Buypass ASNorwayEm breve
  • itsmeBelgium, Luxembourg, Netherlands · Belgian Mobile IDBelgiumLuxembourgNetherlandsEm breve
  • iDINNetherlands · Dutch banks (Currence iDIN)NetherlandsEm breve
  • Finnish Trust NetworkFinland · Finnish banks and mobile operators (FTN)FinlandAtivo
  • PersonalausweisGermany · Bundesministerium des Innern (eID)GermanyEm breve
  • Freja eIDSweden · Freja eID GroupSwedenEm breve
  • UAE PASSUnited Arab Emirates · UAE Digital Government AuthorityUnited Arab EmiratesEm breve
  • gov.brBrazil · Governo Federal do BrasilBrazilEm breve
  • OneIDUnited Kingdom · OneID (UK bank-verified identity)United KingdomEm breve
  • GOV.UK WalletUnited Kingdom · UK Government Digital ServiceUnited KingdomEm breve
  • Smart-IDEstonia, Latvia, Lithuania, Belgium · SK ID SolutionsEstoniaLatviaLithuaniaBelgiumAtivo
  • Mobile-IDEstonia, Lithuania · SK ID Solutions with the national mobile operatorsEstoniaLithuaniaAtivo
  • Bank iDCzechia · Bankovní identita, a.s.CzechiaEm breve
  • MojeIDCzechia · CZ.NICCzechiaEm breve
  • DiiaUkraine · Ministry of Digital Transformation of UkraineUkraineEm breve
  • FranceConnectFrance · DINUM (French state)FranceEm breve
  • AuðkenniIceland · Auðkenni (Icelandic electronic ID)IcelandEm breve
  • ConnectIDAustralia · Australian Payments PlusAustraliaEm breve
  • EUDI Wallet30 países da UE e EEE · The user's own member state; the issuer differs per countryAustriaBelgiumBulgariaCroatia+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

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.

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.
01 · O catálogo

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.
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.
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.
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.
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.
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.
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.
POST /v3/session/UI Alojada
$ curl -X POST https://verification.didit.me/v3/session/ \
  -H "x-api-key: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "workflow_id": "<your-workflow-uuid>",
    "vendor_data": "user_42"
  }'
201Criado{ "url": "https://verify.didit.me/..." }
A Didit mostra as carteiras digitais aceites e gere a transição.documentação
POST /webhooks/diditWebhook
// 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);
});
200OK{ "verification_method": "wallet", "assurance": "cryptographic" }
Integração pronta para agente

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
Precisa de mais contexto? Consulte a documentação completa do módulo.docs.didit.me →
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.
Ler o dossiê de segurança e conformidade
SOC 2 · Type II — AICPA · 2026
SOC 2 · Type I — AICPA · 2026
ISO/IEC 27001 — Segurança da informação · 2026
Sandbox financeiro da UE — Tesoro · SEPBLAC · BdE
FIDO Alliance — Membro associado · 2026
iBeta Level 1 PAD — NIST / NIAP · 2026
GDPR — EU 2016/679
HIPAA — 45 CFR §160 · §164
DORA — EU 2022/2554
MiCA — EU 2023/1114
EBA onboarding remoto — EBA/GL/2022/15
AMLD6 · eIDAS 2.0 — Alinhado com a UE por design
Jugendschutz geprüft — FSM · JMStV §4(2) · 2026

Números de prova

Números de prova
  • 23
    Carteiras digitais no catálogo de métodos
  • 35
    Países no catálogo
  • 10
    Carteiras digitais com alta garantia eIDAS
  • $0.15
    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.

Leia a documentação detalhada
Preços e disponibilidade da carteira de identidade digital
Carteira de identidadeUSD / verificação concluídaPaís / regiãoDisponibilidade em produção
MitID personal0,25 US$
  • Denmark
Disponível
BankID Sweden0,20 US$
  • Sweden
Disponível
Finnish Trust Network0,25 US$
  • Finland
Disponível
Smart-ID0,20 US$
  • Estonia
  • Latvia
  • Lithuania
  • Belgium
Disponível
Mobile-ID0,20 US$
  • Estonia
  • Lithuania
Disponível
BankID Norway High0,35 US$
  • Norway
Brevemente
Vipps Plus0,25 US$
  • Norway
Brevemente
Buypass IDBrevemente
  • Norway
Brevemente
itsmeBrevemente
  • Belgium
  • Luxembourg
  • Netherlands
Brevemente
iDIN full identification0,85 US$
  • Netherlands
Brevemente
Personalausweis Profile 20,45 US$
  • Germany
Brevemente
Freja eID0,25 US$
  • Sweden
Brevemente
UAE PASSBrevemente
  • United Arab Emirates
Brevemente
gov.brBrevemente
  • Brazil
Brevemente
OneID2,50 US$
  • United Kingdom
Brevemente
GOV.UK WalletBrevemente
  • United Kingdom
Brevemente
Bank iDBrevemente
  • Czechia
Brevemente
MojeIDBrevemente
  • Czechia
Brevemente
DiiaBrevemente
  • Ukraine
Brevemente
FranceConnectBrevemente
  • France
Brevemente
AuðkenniBrevemente
  • Iceland
Brevemente
ConnectIDBrevemente
  • Australia
Brevemente
EUDI WalletBrevemente
  • 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-card0,55 US$
  • Estonia
Brevemente
eParaksts mobile0,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 IA Agente de IA na consola, documentação e comunidade.
Mais popular

Pague à medida que usa

$0.33por KYC completo

Mais de 25 módulos, preços públicos. Descontos automáticos por volume.

Tudo o que está incluído em Grátis, e ainda:
  • Rastreio e monitorização AML a partir de 0,07 $
  • Preços de registo comercial por país e nível de dados
  • Monitorização de transações a $0.02 cada
  • Rastreio de carteiras a $0.15 por verificação
  • Fluxo white-label com a sua própria marca
  • Apoio de IA Agente de IA na consola, documentação e comunidade.

Enterprise

Personalizadocontrato anual

Para grandes volumes e programas regulados.

Tudo o que está incluído em Pague à medida que usa, e ainda:
  • Contratos anuais, preços por volume comprometido
  • Termos legais personalizados e um SLA de 99,99% de uptime
  • Residência de dados, retenção, revisão de segurança
  • Revisores manuais sob demanda
  • Termos para revendedores e white-label
  • Apoio humano prioritário Canal partilhado de Slack 24/7, gestor de sucesso dedicado.

Os descontos por volume são aplicados automaticamente à medida que o uso aumenta — sem negociações, sem chamadas de vendas.

FAQ

Perguntas frequentes

O que é o Didit?

O Didit é a infraestrutura para identidade e fraude, a plataforma que gostaríamos que existisse quando estávamos a construir os nossos próprios produtos: aberta, flexível e amigável para programadores, para que funcione como uma parte real da sua stack em vez de uma caixa preta que integra à volta.

Uma API abrange a verificação de pessoas (KYC, know your customer), a verificação de empresas (KYB, know your business), a triagem de carteiras de criptomoedas (KYT, know your transaction), e a monitorização de transações em tempo real, numa stack construída para ser:

  • Rápida, p99 abaixo de 2 segundos em cada sessão
  • Fiável, em produção com mais de 3.000 empresas em mais de 220 países
  • Segura, SOC 2 Tipo 1 e Tipo 2, ISO 27001, nativa do GDPR, e formalmente atestada pelo regulador financeiro de Espanha como mais segura do que verificar alguém presencialmente

A base subjacente: mais de 14.000 tipos de documentos em mais de 48 idiomas, mais de 1.000 fontes de dados e mais de 200 sinais de fraude em cada sessão. A infraestrutura Didit aprende dinamicamente de cada sessão e melhora a cada dia.

O que é uma verificação de carteira de identificação digital?

O utilizador autentica-se com uma identidade eletrónica (eID) existente, e a Didit verifica a evidência de identidade assinada antes de registar o resultado na sessão. A interação depende da carteira: a Smart-ID pede um código pessoal, enquanto a Mobile-ID também pede um número de telefone. Ambas usam um código de comparação e aprovação no dispositivo do utilizador.

A autenticação por carteira é um método dentro da Verificação de Identidade, juntamente com a captura de documentos e a pesquisa sem documentos. Na API de workflow, essa funcionalidade é designada por OCR. As carteiras disponíveis dependem do país e do ambiente. Comece com a documentação das carteiras.

Que carteiras de identidade digital posso ativar em produção?

MitID, BankID Suécia, Finnish Trust Network, Smart-ID e Mobile-ID estão disponíveis. MitID serve a Dinamarca, BankID a Suécia e Finnish Trust Network a Finlândia; Smart-ID cobre Estónia, Letónia, Lituânia e Bélgica; Mobile-ID cobre Estónia e Lituânia. As restantes carteiras listadas, como iDIN, BankID Noruega, Freja eID, ConnectID e a carteira EUDI, chegam em breve.

Escolha as carteiras aceites para cada país na consola. A API de fluxo de trabalho utiliza o catálogo para o seu ambiente e país. Utilize o guia de integração para configurar o fallback de documentos.

Como é que os utilizadores de Smart-ID e Mobile-ID verificam a sua identidade?

O utilizador escolhe uma carteira aceite, introduz o seu código pessoal e fornece um número de telefone para o Mobile-ID. A Didit exibe um código de comparação. O utilizador verifica se o código corresponde ao do seu telemóvel e aprova o pedido de autenticação lá. O PIN é introduzido apenas no dispositivo do utilizador, nunca na Didit.

Didit aguarda a resposta assinada, verifica a assinatura e o estado do certificado, e devolve os atributos de identidade verificados à sessão. O tempo de conclusão depende do utilizador e da resposta da carteira. Siga o guia Smart-ID e Mobile-ID.

Como é que a Didit verifica a autenticação Smart-ID e Mobile-ID?

A Didit verifica a assinatura de autenticação em relação ao desafio para essa sessão, verifica o certificado em relação a emissores fidedignos e verifica o seu estado de revogação. A identidade devolvida deve corresponder ao código pessoal e ao país usados para o pedido. O fluxo alojado também valida o seu token de sessão e rejeita tentativas repetidas de conclusão.

Estas verificações ligam a resposta assinada ao utilizador e pedido esperados. Não substituem a necessidade de o utilizador comparar códigos e proteger o seu dispositivo. Leia o método de verificação, o fornecedor da carteira e os atributos assinados no resultado da sessão, e verifique as assinaturas de webhook antes de usar um resultado na sua aplicação. Consulte o guia técnico.

O que acontece se um utilizador não tiver carteira, cancelar ou o início de sessão falhar?

Um único controlo abrange os três casos: sem carteira, cancelado ou início de sessão falhou. Ou recorre à captura de documentos ou recusa a sessão, e pode definir isso por país.

O resultado regista o método de fallback e a razão, para que um início de sessão abandonado na carteira nunca passe despercebido.

Que países suportam Smart-ID e Mobile-ID na Didit?

O Smart-ID está disponível para a Estónia, Letónia, Lituânia e Bélgica. O Mobile-ID está disponível para a Estónia e Lituânia. O Mobile-ID não é suportado para a Letónia. Os utilizadores precisam de uma credencial elegível para a carteira selecionada.

Ative cada carteira para o país correspondente no seu fluxo de trabalho. Leia o guia Smart-ID e Mobile-ID para os passos de autenticação, campos de identidade verificados e fallback de documentos.

Onde residem os dados dos meus clientes e como são protegidos?

Criptografados em trânsito e em repouso, na região que escolher, sob SOC 2 Type 1 e Type 2, ISO 27001 e GDPR.

Uma carteira partilha apenas os atributos solicitados, e pode desmarcar qualquer atributo opcional para que nunca seja armazenado. Os atributos obrigatórios são sempre armazenados, juntamente com a referência da asserção assinada de que um auditor necessita.

Detalhes completos em /security-compliance.

A Didit está em conformidade com a minha indústria?

A Didit está em produção com mais de 3.000 empresas em indústrias reguladas — fintech, banca, iGaming, cripto, marketplaces, saúde e governo.

O início de sessão com carteira atinge a garantia criptográfica, a prova mais forte dos três métodos, e o nível de garantia é registado em cada sessão. Quando um regulador nomeia um eID nacional específico, aceitar essa carteira é geralmente a forma mais simples de o satisfazer.

Memos em /security-compliance.

Em quanto tempo consigo integrar e começar a verificar utilizadores?

Em minutos, de três formas.

  • Sem código — construa o fluxo de trabalho na consola, selecione as carteiras que aceita por país e envie um link ao seu utilizador.
  • SDK ou redirecionamento — Web, iOS, Android, React Native e Flutter, ou uma página alojada.
  • Agente de IA — cole o prompt de integração desta página no Claude Code, Cursor ou Codex e deixe-o configurar tudo, incluindo o webhook.

Comece em business.didit.me, ou leia docs.didit.me/integration/integration-prompt.

Infraestrutura para identidade e fraude.

Uma API para KYC, KYB, Monitorização de Transações e Rastreio de Carteiras. Integre em 5 minutos.

Peça a uma IA para resumir esta página