Solución de problemas

En la guía de solución de problemas de Android, se abordan problemas y preguntas relacionados con los siguientes temas.

La app se está ejecutando en un entorno de pruebas.

Es posible que el usuario vea el siguiente mensaje cuando elija una tarjeta de pago en el diálogo de detalles de pago:

La app se está ejecutando en un entorno de pruebas. Las transacciones no generarán cargos reales

Este error indica que la app usa ENVIRONMENT_TEST y no recibe credenciales de pago reales, pero sí recibe información personal que incluye la dirección de facturación, el número de teléfono de la dirección de facturación, la dirección de envío y la dirección de correo electrónico si se solicitan.

Se produjo un error en la solicitud

El mensaje de error más común es OR_BIBED_06. Este mensaje de error también aparece en la IU como un diálogo con el siguiente texto:

Request Failed
Hay un problema con la integración de Google Pay del comercio. Comunícate con el comercio para obtener ayuda o paga con otro método.

Para obtener más información sobre este error, sigue estos pasos:

  1. Asegúrate de que Android Debug Bridge (adb) esté instalado en tu computadora.
  2. Asegúrate de que la depuración por USB esté habilitada en tu dispositivo. Para obtener más información, consulta Cómo depurar tu app.
  3. Conecta tu dispositivo Android a la computadora o inicia el simulador.

  4. Ejecuta el siguiente comando en una terminal o un símbolo del sistema en tu computadora:

    adb logcat -s WalletMerchantError

La respuesta indica el motivo del error. Por ejemplo, es posible que veas lo siguiente:

02-26 17:41:28.133 14593 14593 W WalletMerchantError: Error in loadPaymentData: This
merchant profile does not have access to this feature.

La acción que debes realizar para resolver el problema depende del mensaje de error.

Validez de la puerta de enlace

Es posible que, en algún momento de la integración, encuentres los siguientes errores relacionados con la validez de la puerta de enlace. En la siguiente lista, se proporcionan algunas sugerencias útiles para solucionar problemas en caso de que surjan estos errores.

OR_BIBED_06 Puerta de enlace desconocida 'yourgateway'
Actualmente, la API de Google Pay no admite el valor de la propiedad gateway que especificaste en tokenizationSpecification. Comunícate con tu puerta de enlace para obtener más información sobre su identificador y los campos asociados, como gatewayMerchantId.
OR_BIBED_06 La puerta de enlace "example" no se puede usar en el modo de producción.
El valor de la propiedad de la puerta de enlace de ejemplo solo se usa con fines de prueba y no se puede usar con un valor del parámetro de entorno WalletOptions establecido en WalletConstants.ENVIRONMENT_PRODUCTION. Comunícate con tu puerta de enlace para obtener más información sobre los parámetros gateway que debes usar con la API de Google Pay.

Registro y acceso

Es posible que, en algún momento de la integración, encuentres los siguientes errores relacionados con el registro y el acceso. En la siguiente lista, se proporcionan algunas sugerencias útiles para solucionar problemas en caso de que surjan estos errores.

OR_BIBED_07 Esta API requiere la versión 8.4 o posterior de la biblioteca de los Servicios de Google Play
Asegúrate de que los Servicios de Google Play estén actualizados en el dispositivo que ejecuta la app.
OR_BIBED_07 No se encontraron claves para este perfil de comercio
Debes registrar tu clave de encriptación pública en Google a través de la Consola de Google Pay y la Billetera para completar una integración de DIRECT tokenizationSpecification type.
OR_BIBED_07 Este perfil de comercio no tiene acceso a esta función.
No completaste el proceso para registrar tu app en la API de Google Pay. Revisa la solicitud de acceso a producción para obtener más información.
OR_BIBED_10 Este comercio se encuentra en una región donde no se acepta Google Pay.
El servicio de Google Pay no está disponible en la región. Consulta la lista de países admitidos para obtener más información
OR_BIBED_11 Este comercio no completó el registro para usar la API de Google Pay. Ve a la consola (https://pay.google.com/business/console) para verificarlo.
No completaste el proceso para registrar tu app en la API de Google Pay. Revisa la solicitud de acceso a producción para obtener más información.
OR_BIBED_12 Esta integración de la API de Google Pay está inhabilitada. Comunícate con nosotros para obtener más información (https://developers.google.com/pay/api/faq#how-to-get-support).
Comunícate con nosotros para obtener más información sobre los pasos necesarios para volver a habilitar la API de Google Pay en tu cuenta.
OR_BIBED_13 Las huellas digitales de la clave de firma {11:22:33:44:55:66:77:88:99:AA:BB:CC:DD:EE:FF:11:22:33:44:55} no coinciden con nuestros registros de esta app.
La API de Google Pay solo se puede usar en el modo de producción si el APK está firmado con la clave de firma correcta. Para obtener más información, consulta Cómo firmar tu app.

Comercios directos

Es posible que encuentres los siguientes errores relacionados con el comercio directo en algún momento de tu integración. En la siguiente lista, se proporcionan algunas sugerencias útiles para solucionar problemas en caso de que surjan estos errores.

Verificación de la firma
Es posible que se produzca un error de verificación de firma si el merchantId es incorrecto. Esto puede ocurrir en el entorno de TEST cuando usas la biblioteca paymentmethodtoken de Tink. Para evitar este problema, establece YOUR_MERCHANT_ID en en lo siguiente:
.recipientId("merchant:YOUR_MERCHANT_ID")
No se puede desencriptar el token
Si usas la biblioteca paymentmethodtoken de Tink para descifrar un token, ten en cuenta lo siguiente:
  • Asegúrate de que el entorno de respuesta de la API de Google Pay corresponda al entorno de Tink. Por ejemplo, si ENVIRONMENT_TEST devolvió la respuesta de la API de Google Pay, Tink apunta al entorno de pruebas para el desencriptado.
  • No modifiques la respuesta de la API de Google Pay antes de que se pase a Tink. Asegúrate de pasar el token completo que se devolvió en la respuesta de la API de Google Pay. Para obtener más detalles, consulta la siguiente nota:
  • Verifica que tengas la clave privada correcta asociada a la clave pública que registraste en Google.
Genera un par de claves públicas y privadas en Windows
Si usas Windows y quieres seguir los pasos que se mencionan en Usa OpenSSL para generar un par de claves pública y privada, asegúrate de instalar Cygwin en tu máquina. Esto es necesario para ejecutar los comandos de Linux.

WebView de Android

OR_BIBED_15 No se pudo cargar correctamente Google Pay porque esta app usa WebView. Los desarrolladores de apps deben seguir las instrucciones para habilitar Google Pay en Android WebView.
Sigue las instrucciones para habilitar la API de Google Pay para Android WebView.

CardInfo

¿Qué es la función CardInfo?
Google Pay indica a los consumidores que hay una tarjeta detrás del botón de pago de Google Pay, que renderiza tanto la red de la marca de la tarjeta como los últimos cuatro dígitos de la tarjeta.
¿Por qué la función CardInfo no se renderiza en mi implementación?

Para que la función CardInfo funcione, se deben cumplir las siguientes condiciones: