Saltar al contingut principal
POST
cURL
Inicia la verificació d’identitat amb Google Wallet des del teu backend, usant la clau d’API de la teva aplicació. No necessites un flux de treball ni un workflow_id. La resposta d’inici descriu la següent acció d’autenticació; no és un resultat d’identitat aprovat.

Cobertura i activació

L’activació de la cartera és independent del desplegament de l’API i de l’elegibilitat de la teva aplicació. Un endpoint documentat no activa una cartera marcada com a «Properament disponible». Per consultar les tarifes publicades actuals, consulta els preus de les carteres d’identitat digital.

Què fa la persona

La teva pàgina o aplicació demana directament a Google Wallet: no hi ha cap redirecció ni cap pàgina allotjada per Didit. Passa next_action.digital_credentials.request a navigator.credentials.get({digital: request}) en un gest de l’usuari, a l’origin amb què has iniciat la sol·licitud, o bé a Android Credential Manager com a GetDigitalCredentialOption. Després, envia la resposta que retorna la cartera a Enviar la resposta de la cartera. Quan la cartera és en un altre dispositiu, el navegador ofereix el seu propi codi QR.

Rebre el resultat

Segueix la guia de l’API de carteres d’identitat digital per fer el seguiment de la verificació i obtenir-ne el resultat. Considera només un resultat completat i verificat com a prova que la cartera ha autenticat la persona. Els atributs d’identitat retornats varien segons la cartera; no donis per fet que hi hagi una adreça, un retrat ni tots els atributs sol·licitats.

Contingut relacionat

Autoritzacions

x-api-key
string
header
requerit

La clau d'API de la teva aplicació, des de Developers -> API keys a la Business Console. La clau primària té accés complet. Una clau amb nom pot tenir l'abast limitat: cap, lectura o escriptura per recurs, limitada a determinats fluxos de treball o a sessions aprovades, a una llista d'adreces IP i a una data de caducitat. 401 significa que la clau és incorrecta, revocada o caducada; 403 significa que no s'ha enviat cap clau, que la clau no té accés a aquest recurs o acció, o que la sol·licitud prové d'una adreça fora de la seva llista d'IP; 404 en una ruta de sessió significa que la sessió està fora dels fluxos de treball o estats de la clau. Una clau sense accés a fitxers multimèdia rep els URL d'imatge, vídeo i PDF com a null, i una clau sense permís d'escriptura de sessions rep els enllaços de sessió i els tokens com a null. Consulta https://docs.didit.me/console/api-keys.

Capçaleres

Idempotency-Key
string

Clau opcional de seguretat en reintents (màxim 255 caràcters). Si es reintenta amb la mateixa clau, cartera i cos, es retorna la verificació original sense iniciar un segon inici de sessió; la mateixa clau amb una altra cartera o cos retorna 409 idempotency_key_reused.

Cos

Inicia una verificació amb Google Wallet (USA, GBR, BRA, SGP, TWN).

country
enum<string>
requerit

País ISO 3166-1 alpha-3 de la identitat Google Wallet.

  • USA - USA
  • GBR - GBR
  • BRA - BRA
  • SGP - SGP
  • TWN - TWN
Opcions disponibles:
USA,
GBR,
BRA,
SGP,
TWN
origin
string
requerit

On la teva pàgina o aplicació farà la petició a la cartera: l'origen https de la teva pàgina (el seu host ha d'estar a allowed_return_hosts de l'aplicació, o ser el seu domini de marca blanca), p. ex. https://app.example.com, o android:apk-key-hash:<base64 SHA-256 del certificat de signatura de la teva aplicació, sense farciment>. La cartera rebutja la sol·licitud des de qualsevol altre lloc.

Required string length: 1 - 256
vendor_data
string | null

La teva pròpia referència per a aquesta verificació (p. ex., el teu identificador d'usuari). Es retorna als resultats i als webhooks.

metadata
object | null

Objecte JSON opcional emmagatzemat amb la verificació i retornat en resultats i webhooks.

sandbox_scenario
string

Només per a aplicacions de sandbox: el resultat simulat ('wallet_cancelled', 'wallet_timeout' o 'wallet_provider_error'); amb qualsevol altre escenari (o sense), la verificació és correcta. Es rebutja en aplicacions en producció. El catàleg complet està disponible a GET /v1/sandbox/scenarios/.

Minimum string length: 1

Resposta

Una verificació de cartera independent, tal com respon cada endpoint de carteres.

request_id
string<uuid>
requerit
wallet_verification
object
requerit
vendor_data
string | null
requerit
metadata
object | null
requerit

L'objecte de metadades enviat a l'inici, o null.

created_at
string<date-time>
requerit
Darrera modificació el 7 de novembre del 2026