Paso 1: Configura la zona de pruebas

La zona de pruebas es un entorno de pruebas para el servicio de identidad de la Billetera de Google. Usa IDs de prueba en lugar de IDs reales, por lo que puedes compilar y depurar tu integración sin tocar los datos de producción.

De forma predeterminada, la Billetera de Google se ejecuta en modo de producción con IDs reales. En este paso, cambiarás un dispositivo de prueba al modo de zona de pruebas y configurarás tu servidor para las solicitudes y respuestas de la zona de pruebas.

Comenzar

Elige tu ruta RP, RV o presencial

1Aquí

Configura la zona de pruebas Agrega la cuenta a la lista de entidades permitidas y cambia de dispositivo

2

Crea un ID de prueba Agrega un pase de identificación de prueba a la Billetera

3

Integración Compila según tu ruta:

Tercero que confía→ Registrador de verificadores→

4

Prueba la integración Ejecuta la lista de tareas de E2E y graba un video

5

Transmite en vivo Inicia la transmisión según tu ruta:

Tercero que confía→ Registrador de verificadores→

Pasos de esta página

A Solicita acceso a la zona de pruebasAgrega tu Cuenta de Google de prueba a la lista de entidades permitidas B Cambia el dispositivo a la zona de pruebasHabilita la zona de pruebas en la configuración de TapAndPay C Confirma el modo de zona de pruebasVerifica la insignia de ZONA DE PRUEBAS en la Billetera de Google D Configura las claves del servidor y la raíz de la IACAConfigura las claves de firma de prueba y la raíz de la IACA de Utopia

Antes de comenzar

• Un dispositivo Android que puedas restablecer Si cambias a la zona de pruebas, se borrarán los datos de la Billetera de producción existentes en el dispositivo, por lo que no debes usar tu teléfono personal.
• Una Cuenta de [e-mail] con la que se haya accedido a la Billetera de Google en ese dispositivo.
• Solo para registradores verificadores: Envía el formulario de incorporación de registradores verificadores con tus certificados de la AC raíz de la zona de pruebas y de producción para que Google pueda agregar tu AC raíz de la zona de pruebas al almacén de confianza de la zona de pruebas. Consulta el Paso 5.A: Envía el formulario de admisión, los certificados raíz y acepta las Condiciones del Servicio.

Paso A: Solicita acceso a la zona de pruebas para tu cuenta de prueba

La opción para alternar entre la zona de pruebas y el entorno de producción está oculta de forma predeterminada. Para habilitar el botón de activación en tu dispositivo de prueba, debes agregar tu Cuenta de Google a la lista de entidades permitidas de la zona de pruebas:

1. Completa el formulario de solicitud de acceso a la zona de pruebas de Google Pay con la Cuenta de Google que usas en la Billetera de Google.
2. Si realizas pruebas desde un país o una región donde aún no se lanzaron oficialmente los IDs digitales, envía también las direcciones de Gmail de tus cuentas de prueba a [e-mail].

Paso B: Cambia tu dispositivo al modo de zona de pruebas

1. Abre la app de Configuración en tu dispositivo de prueba de Android.
2. Presiona tu Cuenta de Google o foto de perfil en la parte superior de la pantalla (aparecerá tu nombre y el mensaje "Preferencias y servicios de Google").
3. Si se te solicita, elige tu perfil y, luego, presiona Todos los servicios.
4. Ve a la categoría Otro y presiona TapAndPay Environment. Si no ves TapAndPay Environment, reinicia tu dispositivo y comienza desde el paso 1. Si aún no aparece, verifica que tu cuenta esté en la lista de entidades permitidas de la zona de pruebas (paso A).

5. Presiona el menú desplegable y selecciona SANDBOX.

   

6. Un diálogo te notificará que el entorno cambió. Presiona Aceptar y reinicia tu dispositivo.

   

7. Abre la Billetera de Google después de reiniciar. Si ves el siguiente diálogo, fuerza la detención y vuelve a abrir la Billetera de Google para que se sincronice con el entorno de zona de pruebas:

   

Nota: Los métodos anteriores para cambiar de entorno (adb y descargas de archivos de zona de pruebas) están obsoletos y ya no funcionan en teléfonos Android.

Paso C: Confirma que tu dispositivo esté en modo de zona de pruebas

1. Abre la app de la Billetera de Google .
2. En la esquina superior derecha, presiona tu foto de perfil o cuenta > Configuración de la Billetera.
3. Ve a la parte inferior de la página. Si ves un mensaje de confirmación que indica SANDBOX, significa que el dispositivo está configurado para llamadas de zona de pruebas. Si no ves ningún mensaje, significa que está en modo de producción.

Figura 1: Modo de producción

Figura 2: Modo de zona de pruebas

Algunos dispositivos no muestran la Billetera de Google en la Configuración de Google. Para abrir la configuración de la Billetera de Google en esos dispositivos, usa adb con el siguiente comando:

adb shell am start -n com.google.android.gms/com.google.android.gms.tapandpay.settings.TapAndPaySettingsActivity

Vuelve a la producción

Repite el paso B, pero selecciona PRODUCTION en lugar de SANDBOX.

Dispositivos con Wear OS

Para habilitar el modo de zona de pruebas en un dispositivo Wear OS conectado, agrega un archivo vacío y reinicia:

adb shell touch /sdcard/Download/android_pay_env_override_sandbox
adb reboot

Para regresar al modo de producción, borra el archivo y reinicia el dispositivo:

adb shell rm /sdcard/Download/android_pay_env_override_sandbox
adb reboot

Paso D: Configura tu servidor para la zona de pruebas

En la zona de pruebas, tu servidor necesita dos elementos:

1. Solicita credenciales de firma en las que confíe la zona de pruebas de la Billetera de Google:
   • Partes de confianza: Usa el par de claves de prueba de la zona de pruebas de confianza previa de Google y los siguientes metadatos de ejemplo. No es necesario que envíes un formulario.
   • Registradores de verificadores: Firma las solicitudes con un certificado de hoja emitido por tu propia AC raíz de la zona de pruebas (después de que Google la agregue al almacén de confianza de la zona de pruebas) y genera tu propio gw_rp_metadata_bytes como se describe en el Paso 3.A: Configura tu perfil de certificado de AC y los metadatos de CBOR.
2. Ancla de confianza de verificación de respuestas: Tanto las partes de confianza como los registradores de verificadores deben agregar el certificado de la zona de pruebas de Utopia al almacén de confianza de su servidor para validar las respuestas de un ID de prueba de la zona de pruebas.

Claves y metadatos de prueba de la zona de pruebas (partes que confían)

Para probar las solicitudes firmadas en el entorno de zona de pruebas sin registrar tus propias claves de producción, puedes usar el siguiente par de claves de prueba. Estas claves se consideran de confianza de forma predeterminada en el entorno de la zona de pruebas.

Advertencia: No uses estas claves en producción.

Instrucciones

1. Usa la clave privada de prueba para firmar tu solicitud (JWS).
2. Incorpora el certificado público de prueba en el encabezado x5c de tu solicitud.
3. Establece el client_id en el x509_hash de este certificado. Consulta Solicitudes firmadas para obtener detalles sobre cómo calcular el hash.
4. Establece gw_rp_metadata_bytes en client_metadata en los siguientes metadatos de la parte de confianza de prueba (CBOR de Base64url).

Clave privada (PEM):

-----BEGIN PRIVATE KEY-----
MIGHAgEAMBMGByqGSM49AgEGCCqGSM49AwEHBG0wawIBAQQggRmIZIHQhXcYIeZ7
KSqS/WwJrsOetdI8ZE4HG0fd+3uhRANCAAR3GR6mdt/NOErO7+XtKqo7orgXWPMI
jEQDeE1PP4KWXTBAhuewPvF8uOiYakz5Jqd1kEFKfiecZEZRrLnC7U+e
-----END PRIVATE KEY-----

Metadatos de la parte de confianza (CBOR en Base64url):

2BhY56Juc2NoZW1hX3ZlcnNpb25idjFnZGlzcGxheaNsZGlzcGxheV9uYW1leBhURVNUIFVTRSBPTkxZIFNhbmRib3ggUlBobG9nb191cml4YWh0dHBzOi8vZm9udHMuZ3N0YXRpYy5jb20vcy9pL3Byb2R1Y3Rsb2dvcy9nb29nbGVnL3Y2L3dlYi02NGRwL2xvZ29fZ29vZ2xlZ19jb2xvcl8xeF93ZWJfNjRkcC5wbmdycHJpdmFjeV9wb2xpY3lfdXJpeCNodHRwczovL3BvbGljaWVzLmdvb2dsZS5jb20vcHJpdmFjeQ

Metadatos de la parte de confianza (volcado de CBOR):

#24# .bstr

{
  "schema_version": "v1",
  "display": {
    "display_name": "TEST USE ONLY Sandbox RP",
    "logo_uri": "https://fonts.gstatic.com/s/i/productlogos/googleg/v6/web-64dp/logo_googleg_color_1x_web_64dp.png",
    "privacy_policy_uri": "https://policies.google.com/privacy"
  }
}

Certificado público (PEM):

Certificate:
    Data:
        Version: 3 (0x2)
        Serial Number:
            97:99:aa:8b:09:93:5a:20:c1:8b:27:6c:e2:da:91:97:f2:b7:79:8d
        Signature Algorithm: ecdsa-with-SHA256
        Issuer: O=Google, OU=Wallet, CN=TEST USE ONLY Sandbox RP
        Validity
            Not Before: Jun  2 00:39:54 2026 GMT
            Not After : Jun  2 00:39:54 2027 GMT
        Subject: O=Google, OU=Wallet, CN=TEST USE ONLY Sandbox RP
        Subject Public Key Info:
            Public Key Algorithm: id-ecPublicKey
                Public-Key: (256 bit)
                pub:
                    04:77:19:1e:a6:76:df:cd:38:4a:ce:ef:e5:ed:2a:
                    aa:3b:a2:b8:17:58:f3:08:8c:44:03:78:4d:4f:3f:
                    82:96:5d:30:40:86:e7:b0:3e:f1:7c:b8:e8:98:6a:
                    4c:f9:26:a7:75:90:41:4a:7e:27:9c:64:46:51:ac:
                    b9:c2:ed:4f:9e
                ASN1 OID: prime256v1
                NIST CURVE: P-256
        X509v3 extensions:
            X509v3 Subject Key Identifier:
                29:CA:DA:07:9B:1F:68:FA:80:01:E1:68:E3:38:E8:5A:5C:28:B1:6A
            X509v3 Authority Key Identifier:
                29:CA:DA:07:9B:1F:68:FA:80:01:E1:68:E3:38:E8:5A:5C:28:B1:6A
            X509v3 Basic Constraints: critical
                CA:TRUE
            1.3.6.1.4.1.11129.10.1:
                . ...?..!H.Z\j...uT2. .u.:.O.... 0
    Signature Algorithm: ecdsa-with-SHA256
    Signature Value:
        30:46:02:21:00:91:94:fa:b9:85:82:92:bd:6a:98:44:73:ec:
        30:26:1f:92:01:8f:5b:06:d7:8f:21:34:dc:76:f0:89:3c:04:
        8c:02:21:00:ae:3e:9d:46:99:bd:63:7a:cc:59:30:66:48:d0:
        75:cc:c9:82:07:ca:39:f1:f0:df:2b:07:7b:32:b9:5b:3f:0a

-----BEGIN CERTIFICATE-----
MIICFDCCAbmgAwIBAgIVAJeZqosJk1ogwYsnbOLakZfyt3mNMAoGCCqGSM49BAMC
MEUxDzANBgNVBAoMBkdvb2dsZTEPMA0GA1UECwwGV2FsbGV0MSEwHwYDVQQDDBhU
RVNUIFVTRSBPTkxZIFNhbmRib3ggUlAwHhcNMjYwNjAyMDAzOTU0WhcNMjcwNjAy
MDAzOTU0WjBFMQ8wDQYDVQQKDAZHb29nbGUxDzANBgNVBAsMBldhbGxldDEhMB8G
A1UEAwwYVEVTVCBVU0UgT05MWSBTYW5kYm94IFJQMFkwEwYHKoZIzj0CAQYIKoZI
zj0DAQcDQgAEdxkepnbfzThKzu/l7SqqO6K4F1jzCIxEA3hNTz+Cll0wQIbnsD7x
fLjomGpM+SandZBBSn4nnGRGUay5wu1PnqOBhTCBgjAdBgNVHQ4EFgQUKcraB5sf
aPqAAeFo4zjoWlwosWowHwYDVR0jBBgwFoAUKcraB5sfaPqAAeFo4zjoWlwosWow
DwYDVR0TAQH/BAUwAwEB/zAvBgkrBgEEAdZ5CgEEIgQg5taUP70bIUiJWlxqkwYP
dVQyoyCvdaw62E8u4ASBIDAwCgYIKoZIzj0EAwIDSQAwRgIhAJGU+rmFgpK9aphE
c+wwJh+SAY9bBtePITTcdvCJPASMAiEArj6dRpm9Y3rMWTBmSNB1zMmCB8o58fDf
Kwd7MrlbPwo=
-----END CERTIFICATE-----

Certificado raíz de la IACA de la zona de pruebas (todos los socios)

Los IDs de prueba aprovisionados en la zona de pruebas están firmados por la autoridad emisora de la zona de pruebas de Google (Utopia). Para validar de forma criptográfica la firma de issuerAuth en las respuestas que se devuelven de un pase de identificación de prueba de la zona de pruebas, agrega este certificado raíz al almacén de confianza de tu verificador (no confíes en él en producción):

Entorno	Emisor / país	Tipo de credencial	Certificado raíz de la IACA
Zona de pruebas	Utopia	Pase de identificación (com.google.wallet.idcard.1)	Descarga el certificado de la zona de pruebas de Utopia

Para obtener certificados raíz de IACA de producción en los estados y países de EE.UU. admitidos, consulta Entidades emisoras y certificados de IACA admitidos.

Tiempo de actividad de la zona de pruebas

El entorno de zona de pruebas no tiene ANS de tiempo de actividad como nuestro entorno de producción. Si encuentras un error que crees que está relacionado con una interrupción de la zona de pruebas, espera un día hábil estadounidense antes de comunicarte con nosotros. Por lo general, las interrupciones se solucionan por sí solas dentro de ese período. Debido a la posibilidad de que exista tiempo de inactividad, no proyectes que ninguno de tus procesos de lanzamiento esenciales dependa del entorno de zona de pruebas.

Próximo paso

Paso 2: Crea un ID de prueba →