La librería de Clip regresa algunos códigos especiales para describir a detalle el motivo del error.
Los códigos de error especiales son 5 caracteres numéricos y están divididos por categorías clasificadas por su dígito inicial. Cada error se acompaña de una cadena de texto con una breve descripción del error.
Importante:
El catálogo de códigos de resultado para el SDK de Clip cubre el desarrollo en plataformas Android y iOS, por lo que no todos los códigos aplican para todas las plataformas ni versiones del SDK.
Por el momento, los siguientes números de código especial sólo aplican para el desarrollo del SDK de Android:
120xx, 13003 - 13005
Códigos estándar sólo para Android
La librería de Clip para Android y sus funciones regresan códigos estándar de Android para demostrar estados de éxito o error cuando se invocan las funciones. Además, en cada caso de error durante la ejecución, se presenta un código personalizado acompañado de la descripción del error.
Los códigos estándar están definidos por el lenguaje de programación.
Códigos estándar:
- -1: la función se realizó correctamente.
- 0: error, algo ocurrió mal.
Códigos especiales para Android
La librería de Clip regresa algunos códigos especiales para describir a detalle el motivo del error. Los códigos de error especiales son 5 caracteres numéricos y están divididos por categorías clasificadas por su dígito inicial. Cada error se acompaña de una cadena de texto con una breve descripción del error.
Tipo |
Código |
Error |
Descripción |
Solicitud de servicio |
10001 |
CONNECTION_ERROR |
Error de conexión a la red. |
Sesión |
20001 |
ALREADY_SIGNED_OUT |
El usuario ya ha cerrado sesión. |
20002 |
BAD_CREDENTIALS |
Combinación de correo electrónico y contraseña incorrectas. |
|
20003 |
INVALID_ACCESS_TOKEN |
El token de acceso expiró. Opcional: Renovar token de acceso. |
|
Conexión |
30001 |
BLUETOOTH_UNAVAILABLE |
Bluetooth desactivado en el dispositivo. |
30002 |
BLUETOOTH_MISSING_PERMISSIONS: |
Permisos para bluetooth faltantes en Manifiesto Android. |
|
30003 |
DEVICE_CONNECTION_LOST |
Pérdida de conexión Bluetooth al lector Clip Plus. |
|
30004 |
DEVICE_FAILED_TO_CONNECT |
Dispositivo falló en conectarse al lector Clip Plus. |
|
30005 |
NO_DEVICES_FOUND |
No se encontraron dispositivos durante la búsqueda bluetooth. |
|
30006 |
NO_READER_DETECTED |
No hay un lector Clip Plus conectado al dispositivo. |
|
Verificación de límite |
40001 |
LIMIT_EXCEEDED |
Límite de transacciones superado. |
40002 |
LIMIT_CHECK_REQUEST_FAILED |
Solicitud de verificación de límite fallida. |
|
40003 |
NO_LOCATION |
El dispositivo no proporcionó ubicación. |
|
40004 |
ZERO_AMOUNT |
Monto de 0 MXN enviado al servicio de verificación de límite. |
|
40005 |
LIMIT_CHECK_TIMEOUT |
Tiempo agotado de solicitud de verificación de límite. |
|
Pago |
50001 |
PAYMENT_DECLINED |
Transacción declinada por el host. |
50002 |
PAYMENT_CANCELED |
El proceso de pago fue cancelado. |
|
50003 |
APPROVED_PAYMENT_CANCELED |
Proceso de pago cancelado en la pantalla de firma después de aprobar la transacción. |
|
50004 |
ZERO_AMOUNT |
Monto de 0 MXN enviado al servicio de pago. |
|
50005 |
PAYMENT_TIMEOUT |
Tiempo de transacción agotado. |
|
50006 |
PAYMENT_ERROR_OTHER |
Sucedió un error desconocido durante la transacción. |
|
50007 |
PAYMENT_REQUEST_FAILED |
Invocación del servicio de pago falló. |
|
50008 |
APPROVED_PAYMENT_NOT_CANCELED |
Ocurrió un error con la solicitud de cancelación de pago. Pago no cancelado. |
|
50009 |
PAYMENT_CONNECTION_LOST |
Conexión perdida durante el proceso de pago. |
|
50010 |
POINT_PAYMENT_DECLINED |
Pago con puntos cancelado . |
|
Cancelación |
60001 |
CANCELED_BY_READER |
La transacción fue cancelada mediante el botón [x] del lector Clip Plus. |
60002 |
CANCELED_BY_USER |
El usuario canceló la transacción. |
|
60003 |
READER_INFO_ERROR |
No se obtuvo información durante la lectura de la tarjeta. |
|
Tarjeta |
70001 |
MISSING_TRACK_INFORMATION |
Error durante la lectura de la banda magnética. |
70002 |
NOT_CHIP_CARD |
La tarjeta insertada no es una tarjeta con chip válida. |
|
70003 |
PROCESS_AS_CHIP |
Se inició una transacción de deslizamiento utilizando una tarjeta con chip. |
|
70004 |
INTERRUPTED |
Lectura de tarjeta interrumpida. |
|
70005 |
CARD_TIMEOUT |
Sin respuesta recibida del lector de tarjetas. |
|
70006 |
CARD_INFO_ERROR |
Error durante la extracción de la información de tarjeta. |
|
70007 |
CARD_NOT_ACCEPTED |
La tarjeta se encuentra en la lista de restricción, por lo tanto, fue rechazada por el SDK. |
|
70008 |
CARD_DECLINED |
Tarjeta declinada por el lector. |
|
Localización |
80001 |
LOCATION_NOT_AUTHORIZED |
Permisos de localización no proporcionados. |
80002 |
NO_LOCATION |
No se recuperó información de localización. |
|
80003 |
PERMISSIONS_DECLINED |
Usuario rechazó proporcionar permisos de localización. |
|
80004 |
LOCATION_OTHER |
Error desconocido durante el procesamiento de la localización. |
|
Validación |
90001 |
MIN_AMOUNT |
Monto de 0 MXN enviado al SDK. |
90002 |
MAX_AMOUNT |
Monto máximo por transacción superado. |
|
90003 |
NO_INTERNET |
No se detectó conexión a internet. |
|
90004 |
NO_GPS_SIGNAL |
El proveedor de localización está apagado. |
|
Otros |
11001 |
TERMINAL_ERROR |
Ocurrió un error con la terminal durante la transacción. |
11002 |
INITIALIZATION_ERROR |
La inicialización de la terminal falló. |
|
Pagos a distancia |
12001 |
REMOTE_PAYMENT_GENERATION_ERROR |
Ocurrió un error durante la creación del link de pago a distancia. |
12002 |
REMOTE_PAYMENT_CANCEL_FAILED |
El proceso de cancelación de un link de pago a distancia falló. |
|
12003 |
REMOTE_PAYMENT_NOT_FOUND |
Detalles de pago a distancia no encontrados. |
|
12004 |
REMOTE_PAYMENT_HISTORY_ERROR |
Ocurrió un error durante la búsqueda de transacciones de pago a distancia. |
|
12005 |
REMOTE_PAYMENT_INVALID_FORMAT_ERROR |
El formato del monto de pago no se ajusta al máximo de cinco dígitos y dos decimales 99999.99. |
|
12006 |
REMOTE_PAYMENT_LIMIT_REACHED_ERROR |
Límite de monto o enlaces de pago a distancias alcanzado. |
|
Historial de pagos |
13001 |
PAYMENT_HISTORY_ERROR |
Ocurrió un error durante la búsqueda de transacciones de pago. |
13002 |
PAYMENT_HISTORY_REFUND_FAILED |
Ocurrió un error en el reembolso de la transacción |
|
13003 |
PAYMENT_HISTORY_DETAIL_NOT_FOUND |
Detalles de transacción no encontrados. |
|
13004 |
PAYMENT_HISTORY_SEND_RECEIPT_EMAIL_FAILED |
Ocurrió un error en el envío del recibo por correo electrónico. |
|
13005 |
PAYMENT_HISTORY_SEND_RECEIPT_SMS_FAILED |
Ocurrió un error en el envío del recibo por mensaje de texto. |