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 iOS y 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.

Service Request

10001 - CONNECTION_ERROR: Network connection error.

Session

20001 - ALREADY_SIGNED_OUT: User has already closed their session.
20002 - BAD_CREDENTIALS: Incorrect email and password combination.
20003 - INVALID_ACCESS_TOKEN: Access token expired. Optional: Renew the access token.

Connection

30001 - BLUETOOTH_UNAVAILABLE: Device’s bluetooth is disabled.
30002 - BLUETOOTH_MISSING_PERMISSIONS: Missing bluetooth permissions in Android Manifest.
30003 - DEVICE_CONNECTION_LOST: Lost Bluetooth connection to the Clip Plus reader.
30004 - DEVICE_FAILED_TO_CONNECT: Device failed to connect to the Clip Plus reader.
30005 - NO_DEVICES_FOUND: No devices found during bluetooth discovery.
30006 - NO_READER_DETECTED: There’s no Clip Plus reader connected to the device.

Limit Check

40001 - LIMIT_EXCEEDED: Merchant’s transaction limit exceeded.
40002 - LIMIT_CHECK_REQUEST_FAILED: Limit-check request failed.
40003 - NO_LOCATION : The device provided no location.
40004 - ZERO_AMOUNT: 0 MXN amount sent to limit-check service.
40005 - LIMIT_CHECK_TIMEOUT: Limit-check request timed out.

Payment

50001 - PAYMENT_DECLINED: The host declined the transaction.
50002 - PAYMENT_CANCELED: The payment process was canceled.
50003 - APPROVED_PAYMENT_CANCELED: Payment process canceled in the signature screen after approving the transaction.
50004 - ZERO_AMOUNT: 0 MXN amount sent to payment service.
50005 - PAYMENT_TIMEOUT: Transaction timed out.
50006 - PAYMENT_ERROR_OTHER: Unknown error happened during the transaction.
50007 - PAYMENT_REQUEST_FAILED: Invocation to payment service failed.
50008 - APPROVED_PAYMENT_NOT_CANCELED: An error occurred with payment cancellation request. Payment not canceled.
50009 - PAYMENT_CONNECTION_LOST: Connection lost during payment process.
50010 - POINT_PAYMENT_DECLINED: Payment with points canceled.

Canceled

60001 - CANCELED_BY_READER: The transaction was canceled using the [x] button of the Clip Plus reader.
60002 - CANCELED_BY_USER: The user canceled the transaction.
60003 - READER_INFO_ERROR: No information obtained while reading the card.

Card

70001 - MISSING_TRACK_INFORMATION: Error while reading the magnetic stripe.
70002 - NOT_CHIP_CARD: The inserted card is not a valid chip card.
70003 - PROCESS_AS_CHIP: A swipe transaction started using a chip card.
70004 - INTERRUPTED: Card reading was interrupted.
70005 - CARD_TIMEOUT: No response received from the card reader.
70006 - CARD_INFO_ERROR: Error while extracting card information.
70007 - CARD_NOT_ACCEPTED: The card was included in the restricted list, hence, it was rejected by the SDK.
70008 - CARD_DECLINED: Card was declined by the reader.

Location

80001 - LOCATION_NOT_AUTHORIZED: Location permissions not provided.
80002 - NO_LOCATION: No location information was retrieved.
80003 - PERMISSIONS_DECLINED: The user declined to provide location permissions.
80004 - LOCATION_OTHER: Unknown error while processing the location.

Validation

90001 - MIN_AMOUNT: 0 MXN amount sent to SDK.
90002 - MAX_AMOUNT: The maximum amount per transaction was exceeded.
90003 - NO_INTERNET: No internet connection detected.
90004 - NO_GPS_SIGNAL: The location provider is turned off.

Other

11001 - TERMINAL_ERROR: An error happened with the terminal during the transaction.
11002 - INITIALIZATION_ERROR: Terminal initialization failed.

Remote Payments

12001 - REMOTE_PAYMENT_GENERATION_ERROR: An error happened during the creation of the remote-payment link.
12002 - REMOTE_PAYMENT_CANCEL_FAILED: The cancellation process of a generated remote-payment link failed.
12003 - REMOTE_PAYMENT_NOT_FOUND: Remote payment details not found.
12004 - REMOTE_PAYMENT_HISTORY_ERROR: An error occurred when searching for payment transactions.
12005 - REMOTE_PAYMENT_INVALID_FORMAT_ERROR: The payment amount format does not conform with the maximum five digits and two decimals 99999.99.
12006 - REMOTE_PAYMENT_LIMIT_REACHED_ERROR: Limit reached for amount or remote payment links.

Payment History

13001 - PAYMENT_HISTORY_ERROR: An error occurred searching for remote payment transactions.
13002 - PAYMENT_HISTORY_REFUND_FAILED: An error occurred at transaction refund.
13003 - PAYMENT_HISTORY_DETAIL_NOT_FOUND: Transaction details not found.
13004 - PAYMENT_HISTORY_SEND_RECEIPT_EMAIL_FAILED: An error occurred sending the receipt via email.
13005 - PAYMENT_HISTORY_SEND_RECEIPT_SMS_FAILED: An error occurred sending the receipt via sms.