• Francia
página de estado
demo
asistencia
FAQContacte el soporte tecnico
Buscar
Categoria
Tags
España
Francia
España
Europa (Inglés)
India
Página principal
Casos de uso
Crear un pago
Crear un pago en vencimientos
Crear un pago multitarjeta
Crear un pago por token
Crear un enlace de pago
Crear una suscripción
Gestione sus suscripciones
Gestione sus transacciones
Analizar los diarios
Docs API
Formulario incrustado
API REST
Formulario en redirección
Pago móvil
Intercambio de ficheros
Ejemplo de código
Medios de pago
Plugins
Guías
Back office Experto
Guías funcionales

Manejo de errores

Presentación

Los errores del SDK móvil se devuelven a través del objeto LyraException que tiene los siguientes parámetros:

Características Descripción
errorCode Permite identificar el error actual (en formato [PREFIXE]_[CODE]).
errorMessage Explicita el error que corresponde al código.
detailedErrorCode Código del error subyacente que causa la excepción (o null).
detailedErrorMessage Mensaje del error subyacente (o null).

Le champ detailedError indique la cause précise de l'erreur.

Tipos de errores

Es necesario diferenciar los errores que ocurren durante la desactivación de los que pueden ocurrir durante la ejecución del SDK.

Errores de desarrollo

Dans ce cas, le SDK lance une exception de type LyraException, qui doit être capturée par le développeur.

Cela peut se produire dans les cas suivants :

  • Après l'appel à la méthode initialize() :

    • Si le format du paramètre publicKey est incorrect, une exception MOBP_001-INVALID_KEY sera levée.

    • Si le format du paramètre apiServerName est incorrect, une exception MOBP_012-UNKNOWN_API_SERVER_NAME sera levée.

  • Après l'appel à la méthode process() :

  • Si le SDK n'est pas initialisé au préalable, une exception MOBP-002-INITIALIZATION_REQUIRED sera levée.

Errores de tiempo de ejecución

En el caso de otros errores, la información se transmite en el objeto LyraException en la función de devolución de callback onError(), como se describe en la guía de integración.

Códigos de error

Un código de error tiene el formato [PREFIJO]_[CÓDIGO]:

[PREFIJO] define la capa de aplicación donde se ha producido el error
[CODIGO] es el código numérico del error.

Existen distintos prefijos:

PREFIJO Descripción EJEMPLO DE ERROR
MOB Error del SDK móvil MOB_004
ACQ Error del adquirente ACQ_001
AUTH Error de autentificación AUTH_149
INT Error de integración (del vendedor) INT_007
PSP Error por parte del medio de pago PSP_001

Se agregan nuevos códigos de error periódicamente (incluso si no actualiza su SDK y su aplicación móvil). Por lo tanto, su implementación debe tener esto en cuenta e integrar un algoritmo genérico de manejo de errores.

Errores ACQ, AUTH, INT y PSP

Estos códigos de error se refieren a las comunicaciones con los servidores de pago (hacia la plataforma de pago, su servidor comercial, etc.). Consulte Códigos de error para obtener detalles sobre este tipo de error.

Recomendación de control de errores

Cualquiera que sea el caso de error, te recomendamos:

  • mostrar siempre un mensaje para informar al usuario que el pago no se ha realizado.
  • para rastrear claramente elerrorCode, eldetailedErrorCodeet leurs messages associés afin de pouvoir analyser les incidents que vous pouvez rencontrer et les résoudre de manière autonome. En cas d'erreur, vous ne devez JAMAIS considérer que le paiement a été effectué.

Errores de MOB

Estos errores ocurren si ocurre un error en el lado del SDK móvil.

CÓDIGO DE ERROR Definición
MOB_001 Invalid public key
MOB_002 SDK initialization is required before calling process
MOB_003 Invalid formToken
MOB_004 Invalid formToken version
MOB_005 Impossible to communicate with server
MOB_006 Network is not available
MOB_007 Invalid response of Lyra Rest API
MOB_008 Payment refused
MOB_009 Payment cancelled
MOB_010 Server timeout error, check IPN
MOB_011 Unknown API Server Name
MOB_012 Unknown Order Status
MOB_013 Payment cannot be cancelled
MOB_014 Payment by Apple Pay not available
MOB_999 Unexpected error

Detalle de los códigos de error

MOB_001

Código MOB_001
DEFINICIÓN Invalid public key

La clave pública proporcionada al inicializar el SDK es incorrecta. Es posible que esté intentando realizar una transacción de prueba con una clave de producción o viceversa. Ver: Requisitos previos

MOB_002

Código MOB_002
DEFINICIÓN SDK initialization is required before calling process

Vous tentez d'appeler la méthode process avant d'avoir appelé la méthode init. Voir : Guide d'intégration Android et Guide d'integration iOS sur l'initialisation du SDK.

MOB_003

Código MOB_003
DEFINICIÓN Invalid formToken

El ID del formulario parece ser incorrecto. Asegúrese de haber seguido las instrucciones proporcionadas en las guías de integración. Si es probable que nada cause un error, comuníquese con el soporte técnico.

MOB_004

Código MOB_004
DEFINICIÓN Invalid formToken version

La versión de identificación del formulario no es correcta. Para asegurarse de tener la versión correcta, llame al método getFormTokenVersion del SDK y pase los resultados al parámetro formTokenVersion del SDK. createPayment.

MOB_005

Código MOB_005
DEFINICIÓN Impossible to communicate with server

Póngase en contacto con el soporte técnico.

MOB_006

Código MOB_006
DEFINICIÓN Network is not available

El dispositivo no parece estar conectado a Internet. Envíe un mensaje al usuario para asegurarse de que haya iniciado sesión.

MOB_007

Código MOB_007
DEFINICIÓN Invalid response of Lyra Rest API

Póngase en contacto con el soporte técnico.

MOB_008

Código MOB_008
DEFINICIÓN Payment refused

Se alcanza el número de intentos adicionales y se rechaza el pago.

MOB_009

Código MOB_009
DEFINICIÓN Payment cancelled

El pago fue cancelado voluntariamente. El comprador ha abandonado voluntariamente la pantalla de pago o se ha llamado al Lyra.cancelProcess().

MOB_010

Código MOB_010
DEFINICIÓN Server timeout error, check IPN

El servidor de pago no respondió en 60 segundos. Esto puede deberse simplemente a una desaceleración temporal, por lo que se recomienda verificar retrospectivamente la notificación IPN y cancelar la transacción para mantener la coherencia.

MOB_011

Código MOB_011
DEFINICIÓN Unknown API Server Name

El valor enviado en el campo apiServerName no se reconoce, probablemente debido a un error tipográfico.

MOB_012

Código MOB_012
DEFINICIÓN Unknown Order Status

Este error aparece si la plataforma de pago devuelve un estado de pago distinto de EN EJECUCIÓN, PAGADO, PARCIALMENTE_PAGADO o NO PAGADO.

MOB_013

Código MOB_013
DEFINICIÓN Payment cannot be cancelled

El pago no se puede cancelar después de una llamada a Lyra.cancelProcess().

MOB_014

Código MOB_014
DEFINICIÓN Payment by Apple Pay not available

Este error aparece después de llamar a Lyra.cancelProcess() con la opción [LyraPaymentOptions.paidMethodType: LyraPaymentMethods.applePay] y el pago a través de Apple Pay no está disponible.

MOB_999

Código MOB_999
DEFINICIÓN Unexpected error

Se ha producido un error inesperado. Contacte a la asistencia.

Lorsque vous contactezl'assistance technique, communiquez :

  • Su número de tienda de 8 dígitos
  • OS y versión del SDK
  • Dispositivo utilizado (iPhone 6S, computadora personal, iPad Pro, etc.)
  • Versión del OS
  • Fecha y hora del error.
  • elerrorCodeYdetailedErrorCodeque encontrarás si este es el caso

Esta información facilita el análisis y la comprensión de su problema.

Jobs
Legal
GDPR
25.20-1.11