Callback errors

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.