Pular para o conteúdo principal
POST
cURL
Inicie a verificação do Google Wallet ID a partir do seu backend usando a chave de API da sua aplicação. Você não precisa de um fluxo de verificação (workflow) nem de um workflow_id. A resposta de início descreve a próxima ação de autenticação; ela não é um resultado de identidade aprovado.

Cobertura e ativação

A ativação da carteira é independente da implantação da API e da elegibilidade da sua aplicação. Um endpoint documentado não ativa uma carteira marcada como Em breve. Para ver as tarifas publicadas atuais, consulte preços das carteiras de identidade digital.

O que a pessoa faz

Sua página ou app solicita diretamente ao Google Wallet: não há redirecionamento nem página hospedada pela Didit. Passe next_action.digital_credentials.request para navigator.credentials.get({digital: request}) em um gesto do usuário na mesma origin em que você iniciou, ou para o Android Credential Manager como GetDigitalCredentialOption. Em seguida, envie o que a carteira retornar para Enviar resposta da carteira. O navegador oferece o próprio QR code quando a carteira está em outro dispositivo.

Receber o resultado

Siga o guia da API de carteiras de identidade digital para acompanhar a verificação e obter o resultado. Considere apenas um resultado concluído e verificado como prova de que a carteira autenticou a pessoa. Os atributos de identidade retornados variam conforme a carteira; não presuma que um endereço, um retrato ou todos os atributos solicitados estejam presentes.

Relacionados

Autorizações

x-api-key
string
header
obrigatório

Chave de API da sua aplicação, em Developers -> API keys no Business Console. A chave principal tem acesso total. Uma chave nomeada pode ter escopo restrito: nenhum acesso, 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á errada, 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 a requisição veio de um endereço fora da sua lista de IPs; 404 em uma rota de sessão significa que a sessão está fora dos fluxos ou status da chave. Uma chave sem acesso a mídia recebe URLs de imagem, vídeo e PDF como null, e uma chave sem permissão de escrita em sessões recebe links e tokens de sessão como null. Consulte https://docs.didit.me/console/api-keys.

Cabeçalhos

Idempotency-Key
string

Chave opcional de segurança para novas tentativas (máximo de 255 caracteres). Tentar novamente com a mesma chave, carteira e corpo retorna a verificação original sem iniciar um segundo login; a mesma chave com outra carteira ou outro corpo retorna 409 idempotency_key_reused.

Corpo

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

country
enum<string>
obrigatório

País ISO 3166-1 alpha-3 da identidade do 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 sua página ou app fará a requisição à carteira: a origem https da sua página (o host dela deve estar em allowed_return_hosts da aplicação ou ser o domínio de marca própria da aplicação), por exemplo https://app.example.com, ou android:apk-key-hash:<base64 do SHA-256 do certificado de assinatura do seu app, sem padding>. A carteira recusa a requisição em qualquer outro lugar.

Required string length: 1 - 256
vendor_data
string | null

Sua própria referência para esta verificação (por exemplo, o id do seu usuário). Retornada nos resultados e nos webhooks.

metadata
object | null

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

sandbox_scenario
string

Apenas aplicações de sandbox: o resultado simulado - 'wallet_cancelled', 'wallet_timeout' ou 'wallet_provider_error'; qualquer outro cenário (ou nenhum) resulta em verificação. 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 avulsa, como todo endpoint de carteira a retorna.

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 1 de novembro de 2026