Saltar para o conteúdo principal
POST
cURL
Use esta operação para uma carteira cuja resposta de início inclui next_action.type = request_digital_credential, como a Google Wallet. Autentique-se com a chave de API da aplicação que iniciou a verificação, a partir do seu backend. Envie exatamente o que a carteira devolveu: {protocol, data} obtido de navigator.credentials.get no navegador, ou o credentialJson analisado a partir do Android Credential Manager. A resposta está cifrada para a Didit, por isso não a altere. A Didit verifica a assinatura do emissor com as raízes de confiança dos emissores, cada valor devolvido com o respetivo digest assinado, e a assinatura do dispositivo sobre o seu origin e este pedido, e depois decide sobre a verificação. Uma resposta pode ser enviada apenas uma vez. Um segundo envio devolve a verificação que já foi decidida. Uma verificação que não aceita uma resposta de carteira responde com 409 e error: "not_a_digital_credentials_wallet". Consulte APIs de carteira de identidade digital para ver a sequência completa, incluindo os exemplos para navegador e Android.

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.

Parâmetros de caminho

request_id
string<uuid>
obrigatório

O request_id devolvido pelo endpoint de início.

Corpo

O que a carteira respondeu à sua página ou aplicação, para uma verificação de request_digital_credential.

response
object
obrigatório

Exatamente o que a carteira devolveu: {protocol, data} da DigitalCredential de navigator.credentials.get, ou o credentialJson analisado da DigitalCredential do Android. Encriptado para a Didit; não o altere.

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