Recursos para IA

Posibles errores del SDK móvil

Consulta la lista de posibles errores devueltos por el Mercado Pago SDK para integraciones móviles y cómo corregirlos.

Cuando el flujo falla, el SDK entrega un error (MercadoPagoCheckoutResult.Error) con los campos errorCode (un valor estable del enum ErrorCode), errorMessage (descripción del error) y errorLocalized (etapa del flujo donde ocurrió el error).

kotlin
sealed class MercadoPagoCheckoutError(
    val errorCode: ErrorCode,
    val errorMessage: String,
    val errorLocalized: String,
    val errorCause: String? = null,
) : Throwable(message = errorMessage)

Código	Descripción	Causa	Posible solución
`NETWORK_CONNECTION_FAILED`	El dispositivo móvil no pudo abrir una conexión de red.	Sin internet, modo avión, red inaccesible o fallo de DNS.	Verifica la conectividad y ofrece un retry al usuario.
`NETWORK_TIMEOUT`	La solicitud superó el tiempo límite.	Servidor lento o mala calidad de red.	Trátalo como recuperable y ofrece un retry al usuario.
`SERVICE_ERROR`	Error en el servidor o en la comunicación con la API.	Parámetros de la API inválidos, fallo de procesamiento o regla de negocio del servicio.	Revisa `errorMessage` y `errorLocalized` para la etapa. Confirma los datos enviados (`MPOrder`, `orderId`, valor, etc.) y los logs del backend.
`INTEGRATION_ERROR`	La SDK está mal configurada o se usa de forma incorrecta.	Configuración obligatoria faltante, inicialización inválida o uso incorrecto de la API (parámetros obligatorios ausentes).	Asegúrate de que `MercadoPagoSDK.initialize(...)` sea llamado al inicio de la aplicación y antes del checkout, con una Public KeyClave pública que es utilizada en el frontend para acceder a información y cifrar datos, sea en la etapa de desarrollo o en la de pruebas. Puedes acceder a ella a través de Tus integraciones en la sección Datos de integración, dirigiéndote a la sección Credenciales ubicada a la derecha de la pantalla y haciendo clic en Prueba. Alternativamente, puedes ingresar a través de Tus integraciones > Datos de aplicación > Pruebas > Credenciales de prueba. (`publicKey`) válida y el país (`countryCode`) correspondiente.
`UNKNOWN`	Error que no encaja en las demás categorías.	Excepción inesperada o tipo de error indeterminado.	Registra `errorMessage` y `errorLocalized` para diagnóstico y muestra un mensaje genérico de fallo con opción de retry al usuario.

AnteriorPosibles errores de la APIVe los principales errores que pueden aparecer al enviar el pago del Checkout API usando la Orders API.

Próximo3DS 2.0Aprende a integrar la tecnología de autenticación 3DS con Checkout API.