Saltar para o conteúdo principal
POST
cURL
Inicie a verificação de identidade com a Google Wallet a partir do seu backend, usando a chave de API da sua aplicação. Não precisa de um fluxo nem de um workflow_id. A resposta inicial descreve a próxima ação de autenticação; não é um resultado de identidade aprovado.

Cobertura e ativação

A ativação da carteira é separada da disponibilização da API e da elegibilidade da sua aplicação. Um endpoint documentado não ativa uma carteira marcada como Em breve. Para os preços publicados atuais, consulte os preços das carteiras de identidade digital.

O que a pessoa faz

A sua página ou aplicação pede diretamente à Google Wallet: não há redirecionamento nem página alojada pela Didit. Passe next_action.digital_credentials.request a navigator.credentials.get({digital: request}) num gesto do utilizador, na origin a partir da qual iniciou, ou ao Android Credential Manager como GetDigitalCredentialOption. Em seguida, envie o que a carteira devolve para Submeter resposta da carteira. O navegador oferece o seu próprio código QR quando a carteira está noutro dispositivo.

Receber o resultado

Siga o guia da API de carteiras de identidade digital para acompanhar a verificação e obter o respetivo resultado. Considere apenas um resultado concluído e verificado como prova de que a carteira autenticou a pessoa. Os atributos de identidade devolvidos variam consoante a carteira; não presuma que estão presentes uma morada, um retrato ou todos os atributos pedidos.

Relacionados

Autorizações

x-api-key
string
header
obrigatório

A chave de API da sua aplicação, a partir de Programadores -> Chaves de API na Business Console. A chave principal tem acesso total. Uma chave nomeada pode ter o âmbito definido: nenhum, leitura ou escrita por recurso, limitada a alguns fluxos ou a sessões aprovadas, a uma lista de endereços IP e a uma data de validade. 401 significa que a chave está incorreta, revogada ou expirada; 403 significa que nenhuma chave foi enviada, que a chave não tem acesso a este recurso ou ação, ou que o pedido veio de um endereço fora da sua lista de IP; 404 numa rota de sessão significa que a sessão está fora dos fluxos ou estados da chave. Uma chave sem acesso a multimédia recebe URLs de imagens, vídeos e PDFs como nulos, e uma chave sem permissão de escrita em sessões recebe ligações de sessão e tokens como nulos. Consulte https://docs.didit.me/console/api-keys.

Cabeçalhos

Idempotency-Key
string

Chave opcional de segurança contra tentativas repetidas (máx. 255 caracteres). Tentar novamente com a mesma chave, carteira e corpo devolve a verificação original sem iniciar sessão uma segunda vez; a mesma chave com outra carteira ou corpo devolve 409 idempotency_key_reused.

Corpo

Iniciar uma verificação com Google Wallet (USA, GBR, BRA, SGP, TWN).

country
enum<string>
obrigatório

País ISO 3166-1 alfa-3 da identidade Google Wallet.

  • USA - USA
  • GBR - GBR
  • BRA - BRA
  • SGP - SGP
  • TWN - TWN
Opções disponíveis:
USA,
GBR,
BRA,
SGP,
TWN
origin
string
obrigatório

Onde a sua página ou aplicação irá solicitar à carteira: a origem https da sua página (o seu host deve constar de allowed_return_hosts da aplicação, ou ser o seu domínio de marca branca), por exemplo, https://app.example.com, ou android:apk-key-hash:<base64 SHA-256 of your app's signing certificate, no padding>. A carteira recusa o pedido em qualquer outro local.

Required string length: 1 - 256
vendor_data
string | null

A sua própria referência para esta verificação (ex.: o seu ID de utilizador). Devolvida nos resultados e webhooks.

metadata
object | null

Objeto JSON opcional armazenado com a verificação e devolvido nos resultados e webhooks.

sandbox_scenario
string

Apenas aplicações em sandbox: o resultado simulado - 'wallet_cancelled', 'wallet_timeout' ou 'wallet_provider_error'; qualquer outro cenário (ou a ausência de cenário) resulta numa verificação bem-sucedida. Rejeitado em aplicações em produção. O catálogo completo está disponível em GET /v1/sandbox/scenarios/.

Minimum string length: 1

Resposta

Uma verificação de carteira autónoma, tal como é devolvida por todos os endpoints de carteira.

request_id
string<uuid>
obrigatório
wallet_verification
object
obrigatório
vendor_data
string | null
obrigatório
metadata
object | null
obrigatório

O objeto de metadados enviado no início, ou nulo.

created_at
string<date-time>
obrigatório
Última modificação em 7 de novembro de 2026