Within the callbacks sent to you, there are two parameters called errorCode and errorReason. These allow you to understand why these errors occur and help inform the players correctly, improving the customer experience.
The errorCode can start with one of seven keywords that identify the source of the error, followed by a standard error code. These keywords are as follows:
- Account: This refers to an issue related to the user’s bank account.
- Bank: This pertains to problems related to the banks involved in the payments.
- Data: This is due to an issue with the information entered.
- Merchant: This refers to an error caused by the merchant.
- Service: This is related to a problem with the Cleo service.
- User: This refers to an issue with the player’s credentials or usage.
- Unknown: Errors where the source cannot be identified.
Below, you can see the various errors, separated by these keywords, including the errorCode as the main label, errorReason, and additionally, a spanish ErrorReason to enhance communication with the end user.
Account - ACCOUNT_CLOSED
- errorReason: The withdrawal wasn't processed. The receipt account is closed by the bank.
- (SP) errorReason: El retiro no fue procesado. La cuenta de destino fue cerrada por el banco.
Account - ACCOUNT_ID_INCORRECT
- errorReason: The withdrawal wasn't processed. The recipient's checking account number does not correspond to the ID entered.
- (SP) errorReason: El retiro no fue procesado. El número de cuenta corriente del destinatario no corresponde al RUT ingresado.
Account - AMOUNT_LIMIT
- errorReason: The withdrawal wasn't processed. The selected amount would overdraw the account.
- (SP) errorReason: El retiro no fue procesado. El monto seleccionado sobregiraría la cuenta.
Account - BLOCKED_ACCOUNT
- errorReason: Account blocked by your bank.
- (SP) errorReason: Cuenta bloqueada por tu banco.
Account - OVER_BANK_ACCOUNT_LIMIT
- errorReason: Bank account limit exceeded.
- (SP) errorReason: Se excedió el límite de cuentas bancarias permitidas.
Account - OVER_BANK_TRX_LIMIT
- errorReason: Bank transaction daily volume limit exceeded.
- (SP) errorReason: Se excedió el límite de volumen diario de transacciones del banco.
Account - RECEIPT_ACCOUNT_DOES_NOT_ACCEPT_TRANSFER
- errorReason: The withdrawal wasn't processed. The receipt account doesn't accept transfers.
- (SP) errorReason: El retiro no fue procesado. La cuenta de destino no acepta transferencias.
Account - TRANSFER_COOLDOWN_24H
- errorReason: A 24-hour cooldown period is required before transferring back to this account.
- (SP) errorReason: Debes esperar un período de 24 horas antes de volver a transferir a esta cuenta.
Bank - ACCUMULATED_AMOUNT_EXCEEDS_MAXIMUM
- errorReason: Accumulated amount exceeds maximum allowed for first transfers.
- (SP) errorReason: El monto acumulado excede el máximo permitido para primeras transferencias.
Bank - BANK_ERROR
- errorReason: The service couldn't connect to the bank due to instability.
- (SP) errorReason: El servicio no se pudo conectar con el banco debido a inestabilidad.
Bank - BANK_UNAVAILABLE
- errorReason: The withdrawal wasn't processed. The transaction was rejected from bank side due to maintenances or instability.
- (SP) errorReason: El retiro no fue procesado. La transacción fue rechazada por el banco debido a mantenimientos o inestabilidad.
Bank - NEW_RECIPIENT_ERROR
- errorReason: The recipient could not be added.
- (SP) errorReason: No se pudo agregar el destinatario.
Bank - OVER_BANK_AMOUNT_LIMIT_FOR_NEW_USER
- errorReason: Over bank amount limit for new users
- (SP) errorReason: Sobrepasa el límite máximo del monto permitido por el banco para nuevos contactos.
Bank - OVER_BANK_AMOUNT_MAXIMUM
- errorReason: Over bank amount maximum limit
- (SP) errorReason: Sobrepasa el límite máximo del monto permitido por el banco.
Bank - SECURITY_REJECTION
- errorReason: Payment rejected due to security reasons.
- (SP) errorReason: Pago rechazado por motivos de seguridad.
Bank - TRANSACTION_WAS_REJECTED
- errorReason: The withdrawal wasn't processed. The transaction was rejected from bank side.
- (SP) errorReason: El retiro no fue procesado. La transacción fue rechazada por el banco.
Bank - UNDER_BANK_AMOUNT_MINIMUM
- errorReason: Under bank amount minimum limit
- (SP) errorReason: Está debajo del límite mínimo del monto permitido por el banco.
Data - ACCOUNT_ID_INCORRECT
- errorReason: The withdrawal wasn't processed. The recipient's checking account number does not correspond to the ID entered.
- (SP) errorReason: El retiro no fue procesado. El número de cuenta corriente del destinatario no corresponde al RUT ingresado.
Data - ACCOUNT_NUMBER_INCORRECT
- errorReason: The payment wasn't processed. The account number is invalid or does not exist.
- (SP) errorReason: El pago no fue procesado. El número de cuenta es inválido o no existe.
Data - DUPLICATED_TRX
- errorReason: The payment wasn't processed. The transaction already exists.
- (SP) errorReason: El pago no fue procesado. La transacción ya existe.
Data - PLAYER_NAME_MISSING
- errorReason: The withdrawal wasn't processed. Player's name is missing. Please ask to support.
- (SP) errorReason: El retiro no fue procesado. Falta el nombre del usuario. Por favor, contacta a soporte.
Data - SOME_BANK_DETAILS_MISSING
- errorReason: The withdrawal wasn't processed. There are some bank details missing. Please ask to support.
- (SP) errorReason: El retiro no fue procesado. Faltan algunos datos bancarios. Por favor, contacta a soporte.
Data - TRANSACTION_WAS_REJECTED
- errorReason: The withdrawal wasn't processed. The transaction was rejected from bank side.
- (SP) errorReason: El retiro no fue procesado. La transacción fue rechazada por el banco.
Merchant - PAYMENT_REJECTED
- errorReason: The withdrawal was rejected by the merchant.
- (SP) errorReason: El reitro fue rechazado por el comercio.
Service - CUSTOMER_HAS_NOT_DONE_DEPOSIT
- errorReason: The withdrawal wasn't processed. The customer hasn't done a deposit yet or there was a problem with customer external key relation.
- (SP) errorReason: El retiro no fue procesado. El cliente aún no ha realizado un depósito o hubo un problema con la relación de la external key del cliente.
Service - FALSE_NEGATIVE_SUSPECT_TRX
- errorReason: False negative suspect trx.
- (SP) errorReason: Posible falso negativo.
Service - SECURITY_REJECTION
- errorReason: Payment rejected due to security reasons.
- (SP) errorReason: Pago rechazado por motivos de seguridad.
Service - SERVICE_UNAVAILABLE
- errorReason: The payment wasn't processed. The service is unavailable.
- (SP) errorReason: El pago no fue procesado. El servicio no está disponible.
Service - SERVICE_UNSTABLE
- errorReason: The payment wasn't processed. The service had an intermittence.
- (SP) errorReason: El pago no fue procesado. El servicio tuvo una intermitencia.
User - ALREADY_KEEP_OPEN_SESSION
- errorReason: Already keep open session.
- (SP) errorReason: Ya hay una sesión abierta.
User - AMOUNT_MISMATCH
- errorReason: The paid amount does not match the requested amount.
- (SP) errorReason: El monto pagado no coincide con el monto solicitado.
User - DO_NOT_HAVE_ENOUGH_MONEY
- errorReason: Do not have enough money in your account for this transaction.
- (SP) errorReason: No tienes suficiente dinero en tu cuenta para esta transacción.
User - ERROR_WITH_MFA
- errorReason: Invalid, expired or blocked mfa device or credentials.
- (SP) errorReason: Dispositivo o credenciales de MFA inválidos, expirados o bloqueados.
User - ID_MISMATCH
- errorReason: The user ID associated with the payment does not match the one that initiated the request.
- (SP) errorReason: El ID de usuario asociado al pago no coincide con el que inició la solicitud.
User - INVALID_OX_EXPIRED_CREDENTIALS
- errorReason: Invalid, expired or blocked credentials.
- (SP) errorReason: Credenciales inválidas, expiradas o bloqueadas.
User - NOT_COMPLETED
- errorReason: The customer started the transaction but did not continue.
- (SP) errorReason: El cliente inició la transacción pero no la continuó.
User - PAYMENT_CLOSED
- errorReason: Payment closed by the user.
- (SP) errorReason: Pago cerrado por el ususario.
User - SIMILAR_TRANSFER_LESS_THAN_3_MINUTES_AGO
- errorReason: Similar transfer less than 3 minutes ago. Try again in a few minutes.
- (SP) errorReason: Se realizó una transferencia similar hace menos de 3 minutos. Intenta nuevamente en unos minutos.
User - TIMEOUT_TOO_MANY_TRIES
- errorReason: Timeout too many tries. Please try again later.
- (SP) errorReason: Tiempo de espera agotado por demasiados intentos. Por favor, inténtalo de nuevo más tarde.
Unknown - NOT_COMPLETED
- errorReason: The customer started the transaction but did not continue.
- (SP) errorReason: El cliente inició la transacción pero no la continuó.
Unknown - UNKNOWN
- errorReason: Unexpected error – the source is unknown. Please try again or contact support.
- (SP) errorReason: Error inesperado – se desconoce la fuente. Por favor, intenta nuevamente o contacta a soporte.
