Saltar al contenido principal
Didit recauda 7,5M $ para construir la infraestructura para identidad y fraude
Didit
Volver al blog
Blog · 20 de noviembre de 2026

Acepta ID de Google Wallet en tu onboarding: guía de integración

Cómo aceptar ID de Google Wallet con Didit: entorno de pruebas, Register con Google, flujo alojado o API independiente, apps Android, respaldo documental y lectura del resultado.

Por DiditActualizado el
accept-google-wallet-id-integration-cover.png

En resumen

Para aceptar la identificación de Google Wallet en su proceso de incorporación, comience a desarrollar en el sandbox, registre cada aplicación de producción en Google una vez desde la consola de Didit y, a continuación, active Google Wallet para un país en un flujo de trabajo o llame a la API independiente desde su propia página o aplicación de Android.

  • Flujo alojado: active Google Wallet en el paso de verificación de identidad y mantenga la captura de documentos como alternativa.
  • API independiente: comience desde su backend, solicite la cartera al hacer clic y envíe la respuesta de la cartera una vez.
  • Considere como prueba de identidad únicamente un resultado verificado y completado obtenido desde su backend.

Última revisión: 20 de noviembre de 2026 · No constituye asesoramiento jurídico

Esta guía está dirigida al desarrollador que escribe la integración y al jefe de producto que la implementa en el registro. Abarca las dos formas de aceptar la identificación de Google Wallet con Didit: el flujo alojado y la API independiente. Para conocer qué se ha lanzado y por qué es importante, lea Verificación de identidad con Google Wallet. Para conocer el estándar de navegador subyacente, lea nuestra guía sobre la Digital Credentials API.

La persona comparte un pase de identidad creado a partir de un pasaporte o, en Estados Unidos, un carné de conducir móvil de un estado compatible, desde Google Wallet u otra cartera de Android compatible. Didit lo acepta en cinco países: Estados Unidos, Reino Unido, Brasil, Singapur y Taiwán.[1]

Dos formas de aceptar la identificación de Google Wallet

Ambas devuelven los mismos atributos verificados y el mismo veredicto signature_valid.[1]

Más rápido de implementar

Flujo alojado (API de sesiones)

  • Didit muestra «Verificar con identidad digital» solo cuando el navegador y el dispositivo lo admiten
  • Las reglas del flujo de trabajo y la alternativa de documentos se ejecutan en la misma sesión
  • Incorpórelo con el SDK web o un iframe

Didit gestiona las pantallas

Control total

API independiente

  • Su página o aplicación de Android solicita la cartera directamente
  • Sin flujo de trabajo, sin workflow_id, sin return_url
  • Usted diseña el botón, el reintento y cualquier alternativa

Su interfaz de usuario gestiona las pantallas

El flujo alojado incluye la alternativa de documentos ya integrada. Una aplicación nativa de Android o una pantalla de registro personalizada se conectan a la API independiente.

Antes de comenzar

Resuelva estos aspectos antes de escribir código.

  • Cree una aplicación en el sandbox: no requiere registro en Google y no consume créditos.[2]
  • Anote el origen HTTPS que solicitará la cartera, como https://app.example.com.
  • Registre el host de dicho origen como nombre de host de retorno de su aplicación o utilice su dominio de marca blanca.[2]
  • Mantenga la clave de API en su backend: cada llamada a Didit incluye x-api-key y se realiza desde el servidor.

La cartera rechaza cualquier solicitud realizada desde un origen distinto al inicial, por lo que el origen no es un detalle que se pueda corregir más tarde.[2] Didit acepta Google Wallet en cinco países.

PaísValor de la APICredenciales que las personas pueden compartir
Estados UnidosUSAPase de identidad de un pasaporte, carné de conducir móvil de los estados de EE. UU. compatibles
Reino UnidoGBRPase de identidad de un pasaporte
BrasilBRAPase de identidad de un pasaporte
SingapurSGPPase de identidad de un pasaporte
TaiwánTWNPase de identidad de un pasaporte

Países y valores de la API para Google Wallet en Didit.[1][2]

Opción 1: el flujo alojado

En el flujo alojado, Google Wallet es un método más en el paso de verificación de identidad de un flujo de trabajo. En la consola, abra el flujo de trabajo, vaya a Verificación de identidad, seleccione un país compatible y active Google Wallet entre las carteras aceptadas. A través de la API, se trata de un bloque wallet por país:

{"USA": {"document": {"enabled": true}, "wallet": {"enabled": true, "providers": ["google_wallet"], "on_failure": "fallback_to_document"}}}

wallet.providers es una lista de aceptación, no una jerarquía: la persona elige entre cualquiera de las que haya aceptado.[1] wallet.on_failure determina qué ocurre cuando el paso de la cartera no finaliza con un resultado verificado.

1Crear una sesión

Su backend llama a la API de sesiones con el flujo de trabajo.

2Didit comprueba el navegador

El método se ofrece únicamente cuando el navegador y el dispositivo pueden consultar una cartera.

La persona comparte una identidad digital

Sí

Verificado

Los atributos firmados se registran en la sesión.

No

Seguir on_failure

Captura de documentos o una verificación de identidad rechazada.

3Leer la decisión

Webhook o resultado de la sesión en su backend.

El flujo alojado con Google Wallet como primer método.

Incrustar el flujo alojado en un iframe

Si el flujo alojado se abre dentro de su propia página, se debe permitir que el navegador solicite una cartera desde el interior del marco. Utilice el SDK web 0.5.1 o posterior, o añada digital-credentials-get al atributo allow del iframe.[1][5]

Atención

Sin digital-credentials-get, el navegador rechaza la solicitud de la cartera dentro del iframe.

Lo que el flujo alojado muestra a sus usuarios

No hay redirección. La persona confirma en el aviso de cartera propio del navegador o de Android, el cual muestra el nombre y el logotipo de su empresa. En un navegador de escritorio, el navegador genera su propio código QR para que la persona pueda responder desde la cartera en su teléfono.[1][2] El botón indica "Verificar con identidad digital", ya que cualquier cartera de Android compatible puede responder, y lleva un icono de cartera genérico.

Paso 1

En el paso de identificación, la persona selecciona la opción etiquetada como "Verificar con identidad digital".

1La persona selecciona la opción de identidad digital.

Paso 2

El navegador o Android abre su propio aviso de cartera con su nombre y logotipo, y la persona aprueba el intercambio en su teléfono.

2El aviso de cartera pertenece al navegador o a Android.

Paso 3

Si la persona cierra el aviso, la página indica "Su cartera no ha finalizado" y ofrece "Intentar de nuevo" o "Escanear su documento de identidad en su lugar".

3Un aviso cancelado conduce a un reintento o a un escaneo de documentos.

Los pasos descritos. Es un esquema, no la imagen de una pantalla real; las etiquetas entrecomilladas son las expresiones propias del flujo alojado.

Opción 2: la API independiente, paso a paso

Con la API independiente, su página o aplicación de Android solicita directamente la cartera a través de la W3C Digital Credentials API.[7] No hay ninguna página alojada por Didit ni código QR de Didit.[2]

Cartera Su página Su backend Didit
1Solicitar inicio
2Iniciar con origen
3Solicitud de cartera
4Solicitud a la página
5Solicitar con un clic

La persona pulsa Compartir

6Protocolo y datos
7Respuesta de la cartera
8Enviar una vez
9Verificación resuelta

La solicitud independiente de Google Wallet. La clave API nunca sale de su backend.

Paso 1: comience con su origen

Su backend llama a POST /v3/id-verification/wallets/google-wallet/ con x-api-key, una Idempotency-Key y un cuerpo JSON que contiene country y origin. Puede añadir vendor_data (su referencia de cliente, hasta 2,000 bytes UTF-8) y metadata.[2][3]

{"country": "USA", "origin": "https://app.example.com", "vendor_data": "your-customer-reference"}

La respuesta incluye un request_id, wallet_verification.interaction = "digital_credentials" y next_action.type = "request_digital_credential". Entregue next_action.digital_credentials.request a la página.

Paso 2: pregunte a la cartera dentro de un gesto del usuario

Llame a navigator.credentials.get({digital: request}) desde el manejador de clics de su botón "Verificar con identidad digital", en el origen con el que empezó. La llamada debe ejecutarse en un gesto del usuario, así que no coloque un paso asíncrono entre el clic y la llamada: obtenga la solicitud antes del clic.[2] Muestre el botón solo donde el navegador pueda hacer esto, por ejemplo cuando "DigitalCredential" in window sea verdadero.

Nota

Un aviso cancelado se rechaza con NotAllowedError o AbortError; NotSupportedError significa que este navegador no puede consultar una cartera. Asigne la cancelación a un reintento y a su ruta de documentos; donde el navegador no pueda consultar una cartera, oculte la opción.[2]

Paso 3: envíe la respuesta de la cartera

Envíe lo que devolvió la cartera, {protocol, data}, a su backend. Desde ahí, llame a POST /v3/id-verification/wallets/verifications/{request_id}/response/ con el cuerpo {"response": {...}}. Envíe una vez: un segundo envío devuelve la verificación que ya se había decidido.[2][4]

Detrás de esa llamada, Didit comprueba la firma del emisor frente a las raíces de emisores de confianza, cada valor devuelto frente a su resumen firmado y la firma del dispositivo sobre su origen y esta solicitud.[4]

Aplicaciones Android

Una aplicación nativa de Android utiliza Jetpack Credential Manager con la misma solicitud.[2][8] Construya un GetDigitalCredentialOption a partir de next_action.digital_credentials.request, llame a getCredential y envíe el credentialJson devuelto a su backend como el cuerpo response.[2]

El origen es diferente. En lugar de un origen HTTPS, envíe android:apk-key-hash: seguido del SHA-256 en base64 del certificado de firma de su aplicación, sin relleno.[2]

ErrorDóndeQué hacer
origin_invalidInicio, 400Envíe un origen HTTPS o un origen de aplicación Android
origin_not_allowedInicio, 400Registre el host como un nombre de host de retorno
not_a_digital_credentials_walletEnviar, 409Esta verificación no acepta la respuesta de una cartera

Los tres errores que se deben gestionar en la integración independiente.[2]

Gestión del resultado y webhooks

La respuesta de envío es la verificación resuelta. También puede consultarla con GET /v3/id-verification/wallets/verifications/{request_id}/ o recibirla en el webhook status.updated con webhook_version: "v3". El session_id del webhook coincide con el request_id y aparece una identidad de cartera con verification_method: "wallet".[2] Verifique la firma del webhook y haga que el controlador sea idempotente: los envíos fallidos se reintentan.

CampoQué indica
full_name, date_of_birthCampos de identidad normalizados en el resultado de la verificación de identidad
wallet_verification.attributesdocument_number, document_expiry_date y los demás atributos compartidos
signature_validVeredicto de Didit sobre la afirmación firmada, que se comprueba dentro de Didit y no se devuelve
assurancecryptographic: la prueba es una credencial firmada
Nivel de garantíaSustancial
portraitnull: Google Wallet no comparte una fotografía, por lo que no hay coincidencia facial con ella

Lo que devuelve una verificación completada de Google Wallet. La nacionalidad se devuelve únicamente para un pase de identidad.[1]

Una credencial que no es válida no constituye una respuesta de error. Es una verificación resuelta con el resultado failed.[2] En el flujo alojado, los mismos resultados activan wallet.on_failure.

ResultadoSignificadoFacturado
verifiedLa persona compartió el documento de identidad y los atributos firmados fueron correctosSí
cancelledLa persona canceló el aviso de la carteraNo
timeoutLa ventana de inicio de sesión ha caducado (10 minutos por defecto para las carteras)No
failedEl inicio de sesión no se completó o la aserción no era válidaNo

Resultados de la cartera y facturación.[1]

Atención

El retorno del navegador o un valor enviado por su propia página no constituyen una prueba de identidad. Apruebe la cuenta únicamente con un resultado verified completado que su backend haya leído de Didit, mediante API o mediante un webhook firmado.[2]

Configuración del método alternativo de documento

No todas las personas tienen una identidad digital, y no todos los navegadores pueden solicitar datos a una cartera. El flujo alojado oculta el método cuando el navegador no puede realizar la solicitud y mantiene la captura de documentos.[1] Con on_failure configurado en fallback_to_document, un intento de cartera cancelado, caducado o fallido envía a la persona a la captura de documentos en la misma sesión. Con decline, la sesión termina con una verificación de identidad rechazada. Si la captura de documentos está desactivada para ese país, fallback_to_document también rechaza la solicitud porque no hay ningún método alternativo al que recurrir.[1]

Didit hosted flow, document capture fallback

El paso de captura de documentos al que llega la persona tras "Escanear su documento en su lugar".

En la API independiente, este paso depende de usted: ofrezca una comprobación de documentos cuando el resultado no sea verified.

Pruebas en sandbox

Una aplicación de sandbox ejecuta los mismos pasos que la producción con una cartera simulada. Las respuestas incluyen simulated: true, cualquier respuesta enviada determina la verificación y no se deducen créditos. Una aprobación simulada es un dato de muestra, no una identidad verificada.[2]

sandbox_scenarioQué prueba
wallet_cancelledSu reintento y método alternativo cuando la persona cancela la operación
wallet_timeoutUna solicitud caducada
wallet_provider_errorUna cartera que no finaliza

Escenarios de sandbox. Las aplicaciones de producción rechazan sandbox_scenario.[2]

Pasar a producción: Registrarse en Google

Cada aplicación de producción se registra en Google una vez. La consola muestra "Funciona en sandbox ahora. Regístrese en Google antes de pasar a producción" en una aplicación de sandbox. Hasta que se registra una aplicación de producción, guardar un flujo de trabajo que activa Google Wallet se rechaza con el mensaje "Registre esta aplicación en Google antes de habilitar Google Wallet".[1]

1Abra el paso de Verificación de identidad

En la consola, busque la fila de Google Wallet de un país admitido.

2Elija Registrarse en Google

Se abre el diálogo "Register with Google Wallet". Solo un administrador puede enviarlo.

3Rellene cinco campos

Nombre de la entidad legal, el nombre que se muestra en Google Wallet, un logotipo cuadrado, una URL de política de privacidad y la finalidad.

4Registrado

La etiqueta cambia de Needs registration a Registering a Registered.

La configuración inicial única toma alrededor de un minuto; la consola indica que suele estar lista en pocos minutos.[1]

El diálogo explica el paso en una línea: "Didit registra su empresa en Google como su verificador. Google lo necesita una vez antes de que sus usuarios puedan compartir con usted su identificación de Google Wallet." El nombre que se muestra en Google Wallet admite hasta 64 caracteres; el logotipo es un archivo PNG o JPG cuadrado de al menos 256 x 256 px. El diálogo también muestra una vista previa de lo que los usuarios van a compartir.

Cómo le ayuda Didit a aceptar la identificación de Google Wallet

Didit gestiona la solicitud de la cartera, el registro en Google, las comprobaciones y la alternativa bajo una misma API, junto con el resto de carteras de identidad digital que admite. La verificación de Google Wallet ID cuesta $0.20 por verificación completada según la tarifa oficial. Los inicios de sesión cancelados, caducados, rechazados o incompletos no se cobran, y la alternativa de documento es una comprobación independiente facturada según la tarifa de verificación de documentos (precios).[6] En la consola: Workflows, ID Verification, Countries, Wallets accepted.

Didit proporciona

  • La solicitud de cartera firmada y el registro en Google
  • Comprobaciones del emisor, resumen y firma del dispositivo
  • El flujo alojado, el entorno de pruebas y la alternativa de documento
  • La verificación resuelta mediante API y webhook

Permanece bajo su control

  • Sus orígenes, nombres de host de retorno y clave de API
  • El botón, el reintento y los textos en su propia interfaz de usuario
  • Qué países y resultados acepta
  • La decisión de incorporación y su política de cumplimiento

Añada Google Wallet a su registro

Constrúyalo hoy en el sandbox, regístrese en Google una vez, y pague solo por las comprobaciones completadas.

Empiece gratisHable con nosotrosLea la documentación

Puntos clave

  • El sandbox no requiere registro; cada aplicación de producción se registra en Google una vez desde la consola.
  • El flujo alojado ofrece "Verificar con identidad digital" solo donde está disponible y mantiene la captura de documentos como alternativa.
  • En un iframe, permita digital-credentials-get o utilice el SDK web 0.5.1 o posterior.
  • Solo un resultado verified completado y leído desde su backend constituye prueba de identidad.

Preguntas frecuentes

¿Necesito un flujo de trabajo (workflow) para utilizar Google Wallet?

No. La API independiente no requiere ningún flujo de trabajo ni workflow_id. El flujo alojado utiliza un flujo de trabajo donde Google Wallet se activa por país.

¿Qué origen debo enviar para una aplicación de Android?

Envíe android:apk-key-hash: seguido del SHA-256 en base64 del certificado de firma de su aplicación, sin relleno. Un sitio web envía el origen HTTPS de su página.

¿Por qué falla la solicitud de la cartera dentro de mi iframe?

El navegador rechaza la solicitud a menos que el iframe lo permita. Añade digital-credentials-get al atributo allow del iframe, o utiliza el SDK web 0.5.1 o posterior.

¿Puedo enviar la respuesta de la cartera dos veces?

La respuesta se envía una vez. Un segundo envío devuelve la verificación ya resuelta.

¿Cómo se muestra una credencial fallida en la API?

Es una verificación resuelta con el resultado failed, no una respuesta de error. En el flujo alojado sigue a wallet.on_failure.

¿Cómo puedo realizar pruebas sin un identificador real de Google Wallet?

Utiliza una aplicación de sandbox. Simula los mismos pasos, devuelve simulated: true, no cobra créditos y sandbox_scenario prueba los fallos.

¿Cómo identifican los webhooks una verificación de cartera?

El parámetro session_id del webhook status.updated coincide con el request_id de la API de la cartera, y la identidad de la cartera incluye verification_method: "wallet". Utiliza webhook_version: "v3" y verifica la firma.

¿Qué ocurre si el origen de mi página difiere del inicial?

La cartera rechaza la solicitud. Inicie la verificación con el origen exacto que solicitará la cartera y registre su host como nombre de host de retorno de su aplicación.

Fuentes

  1. Carteras de identidad digital: Google Wallet, fallos y alternativas, precios, documentación de Didit, consultado el 20 de noviembre de 2026.
  2. APIs de carteras de identidad digital: carteras de credenciales digitales (Google Wallet), webhooks, entorno de pruebas, documentación de Didit, consultado el 20 de noviembre de 2026.
  3. Referencia de la API: Google Wallet, documentación de Didit, consultado el 20 de noviembre de 2026.
  4. Enviar una respuesta de cartera de identidad digital, documentación de Didit, consultado el 20 de noviembre de 2026.
  5. Integración de iframe en contexto, documentación de Didit, consultado el 20 de noviembre de 2026.
  6. Precios, documentación de Didit, consultado el 20 de noviembre de 2026.
  7. Digital Credentials API: Identidad segura y privada en la web, Chrome for Developers, 3 de octubre de 2025.
  8. Verificar credenciales digitales, Android Developers.

Los mismos patrones se aplican también a la verificación de eID. Para ver todas las carteras que puede aceptar, consulte las carteras de identidad digital en Didit.

Acepte la identificación de Google Wallet con Didit

Active Verificación con identidad digital en un flujo de trabajo o llame a la API de la cartera desde su propia página.

Empiece gratisHable con nosotros

Infraestructura para identidad y fraude.

Una API para KYC, KYB, Monitoreo de Transacciones y Detección de Fraude en Wallets. Intégrala en 5 minutos.

Pide a una IA que resuma esta página