Uso de terminal

Uso de la Función printStr

Esta función toma la cadena de texto formateada, la longitud del papel y un PrintCallback para manejar los eventos del proceso de impresión.

Callback: PrintCallback

• Descripción: Callback utilizado para recibir los eventos y estados durante el proceso de impresión del ticket.
• Valores:
  • onError: Este método se invoca cuando ocurre un error durante el proceso de impresión del ticket.
    • Parámetros:
      • error (ErrorResponse): Un código y mensaje de error opcional que describe el fallo.
        • code código de error
        • message mensaje de error
    • Descripción: Se llama cuando hay un error en el proceso de impresión del ticket.
  • onSuccessful: Este método se invoca cuando el ticket se ha impreso exitosamente.
    • Descripción: Se llama cuando el ticket se imprime exitosamente.
    • Retorno: Ejecuta el callback proporcionado para realizar acciones adicionales después de la impresión.

checkServices.printStr(
    "Folio: 3123123" + "\n" +
    "Amount: 150"  + "\n",
    object : PrintCallback.Stub() {
		    override fun onError(error: ErrorResponse) {
	          Log.e("printStr", error.code)
	      }

        override fun onSuccessful() {
            callback()
        }
    }
)

checkServices.printStr(
    "Folio: 3123123" + "\n" +
    "Amount: 150"  + "\n",
    object : PrintCallback.Stub() {
		    override fun onError(error: ErrorResponse) {
	          Log.e("printStr", error.code)
	      }

        override fun onSuccessful() {
            callback()
        }
    }
)

        CheckServices checkServices = CheckServices.getInstance(this);
            checkServices.printStr(textToPrint, 15, new PrintCallback.Stub() {
                @Override
                public void onSuccessful() {
										// Success
                }
	          @Override
	          public void onError(ErrorResponse error) {
              Log.d("printStr", error.code );
            }
            });

        CheckServices checkServices = CheckServices.getInstance(this);
            checkServices.printStr(textToPrint, 15, new PrintCallback.Stub() {
                @Override
                public void onSuccessful() {
										// Success
                }
	          @Override
	          public void onError(ErrorResponse error) {
              Log.d("printStr", error.code );
            }
            });

Anexo de datos para tickets

Anexo de datos requeridos en ticket de compra

Imprimir Bitmap

La función printBitmap se utiliza para imprimir un bitmap en la aplicación Pagando Check². A continuación, se describen los detalles de la función y se proporciona un ejemplo de su uso.

Parámetros

• imageBitmap: Bitmap
  • Descripción: La imagen representada como un objeto Bitmap que se imprimirá.
  • Ejemplo: imageBitmap

Callback: PrintCallback

• Descripción: Callback utilizado para recibir los resultados del intento de impresión.
• Métodos:
  • onError: Este método se invoca cuando ocurre un error durante el intento de impresión.
    • Parámetros:
      • error (ErrorResponse): Un código y mensaje de error opcional que describe el fallo.
        • code código de error
        • message mensaje de error
    • Descripción: Se llama cuando hay un error en el proceso de impresión.
    • Retorno: No retorna un valor, pero proporciona información sobre el error ocurrido.
  • onSuccessful: Este método se invoca cuando la impresión se completa exitosamente.
    • Descripción: Se llama cuando la impresión se completa exitosamente.
    • Retorno: No retorna un valor, pero indica que el proceso de impresión fue exitoso.

/*
Declara una variable de solo lectura llamada
**checkServices** de tipo **CheckServices** y le asigna
la instancia de **CheckServices** obtenida mediante
el llamado al método **getInstance(context)**.
*/
val checkServices: CheckServices = CheckServices.getInstance(App.appContext)

/*
Llamada de la función printBitmap que recibe como
parámetro un bitmap y un PrintCallback que podría
tener dos métodos: onError y onSuccessful.
*/
checkServices.printBitmap(imageBitmap,
    object : PrintCallback.Stub() {
		    override fun onError(error: ErrorResponse) {
	          Log.e("printBitmap", error.code)
	      }

        override fun onSuccessful() {
            callback()
        }
    })

/*
Declara una variable de solo lectura llamada
**checkServices** de tipo **CheckServices** y le asigna
la instancia de **CheckServices** obtenida mediante
el llamado al método **getInstance(context)**.
*/
val checkServices: CheckServices = CheckServices.getInstance(App.appContext)

/*
Llamada de la función printBitmap que recibe como
parámetro un bitmap y un PrintCallback que podría
tener dos métodos: onError y onSuccessful.
*/
checkServices.printBitmap(imageBitmap,
    object : PrintCallback.Stub() {
		    override fun onError(error: ErrorResponse) {
	          Log.e("printBitmap", error.code)
	      }

        override fun onSuccessful() {
            callback()
        }
    })

Inicio de Sesión con API (Credenciales Pagando Check²)

La función loginApi permite la autenticación utilizando credenciales de Pagando Check² mediante una API. Este método es útil cuando se requiere autenticar a un usuario utilizando un token y un código secreto.

Parámetros

• apiToken: String
  • Descripción: El token de la API utilizado para la autenticación.
  • Ejemplo: "fOSPB2QQUqNSa2l9BkKo"
• apiSecret: String
  • Descripción: El código secreto de la API utilizado para la autenticación.
  • Ejemplo: "7431a08664e9d2ee3d2e80dde59439db7d632945"

Callback: LoginCallback

• Descripción: Callback utilizado para recibir los resultados del intento de inicio de sesión.
• Métodos:
  • onSuccessful: Este método se invoca cuando el inicio de sesión es exitoso.
    • Descripción: Se llama cuando el inicio de sesión se completa exitosamente.
    • Retorno: No retorna un valor, pero indica que el proceso de inicio de sesión fue exitoso.
  • onError: Este método se invoca cuando ocurre un error durante el intento de inicio de sesión.
    • Parámetros:
      • errorCode (String?): Un código o mensaje de error opcional que describe el fallo.
    • Descripción: Se llama cuando hay un error en el proceso de inicio de sesión.
    • Retorno: No retorna un valor, pero proporciona información sobre el error ocurrido.

/*
Declara una variable de solo lectura llamada
**checkServices** de tipo **CheckServices** y le asigna
la instancia de **CheckServices** obtenida mediante
el llamado al método **getInstance(context)**.
*/
val checkServices: CheckServices = CheckServices.getInstance(context)

/*
Llamada de la función loginApi que recibe como parámetros el token de la API y el código secreto.
Responde a un LoginCallback que podría tener dos métodos: onSuccesfull y onError.
*/
checkServices.loginApi(apiToken, apiSecret,
    object : LoginCallback.Stub() {
        override fun onSuccessful() {
            // Realizar acciones adicionales cuando el inicio de sesión es exitoso
            saveLoginState(context, true)
        }

        override fun onError(errorCode: String?) {
            // Manejar el error de inicio de sesión, por ejemplo, registrar el error
            Log.e("error", errorCode!!)
        }
    })

/*
Declara una variable de solo lectura llamada
**checkServices** de tipo **CheckServices** y le asigna
la instancia de **CheckServices** obtenida mediante
el llamado al método **getInstance(context)**.
*/
val checkServices: CheckServices = CheckServices.getInstance(context)

/*
Llamada de la función loginApi que recibe como parámetros el token de la API y el código secreto.
Responde a un LoginCallback que podría tener dos métodos: onSuccesfull y onError.
*/
checkServices.loginApi(apiToken, apiSecret,
    object : LoginCallback.Stub() {
        override fun onSuccessful() {
            // Realizar acciones adicionales cuando el inicio de sesión es exitoso
            saveLoginState(context, true)
        }

        override fun onError(errorCode: String?) {
            // Manejar el error de inicio de sesión, por ejemplo, registrar el error
            Log.e("error", errorCode!!)
        }
    })

En este ejemplo, la función loginApi se utiliza para autenticar a un usuario utilizando un token y un código secreto de la API. La lógica de la aplicación maneja acciones adicionales después de un inicio de sesión exitoso o maneja errores en caso de falla.

Cierre de Sesión (Logout Pagando Check²)

La función logout se utiliza para cerrar la sesión de un usuario en Pagando Check².

Callback: LogoutCallback

• Descripción: Callback utilizado para recibir los resultados del intento de cierre de sesión.
• Métodos:
  • onSuccessful: Este método se invoca cuando el cierre de sesión es exitoso.
    • Descripción: Se llama cuando el cierre de sesión se completa exitosamente.
    • Retorno: No retorna un valor, pero indica que el proceso de cierre de sesión fue exitoso.
  • onError: Este método se invoca cuando ocurre un error durante el intento de cierre de sesión.
    • Parámetros:
      • errorCode (String?): Un código o mensaje de error opcional que describe el fallo.
    • Descripción: Se llama cuando hay un error en el proceso de cierre de sesión.
    • Retorno: No retorna un valor, pero proporciona información sobre el error ocurrido.

/*
Declara una variable de solo lectura llamada
**checkServices** de tipo **CheckServices** y le asigna
la instancia de **CheckServices** obtenida mediante
el llamado al método **getInstance(context)**.
*/
val checkServices: CheckServices = CheckServices.getInstance(context)

/*
Llamada de la función logout que responde a un LogoutCallback
que podría tener dos métodos: onSuccessful y onError.
*/
checkServices.logout(object : LogoutCallback.Stub() {
    override fun onSuccessful() {
        // Cerrar sesión exitosamente, puede avanzar a la siguiente pantalla
    }

    override fun onError(errorCode: String?) {
        // Mostrar mensaje de error en el cierre de sesión
    }
})

/*
Declara una variable de solo lectura llamada
**checkServices** de tipo **CheckServices** y le asigna
la instancia de **CheckServices** obtenida mediante
el llamado al método **getInstance(context)**.
*/
val checkServices: CheckServices = CheckServices.getInstance(context)

/*
Llamada de la función logout que responde a un LogoutCallback
que podría tener dos métodos: onSuccessful y onError.
*/
checkServices.logout(object : LogoutCallback.Stub() {
    override fun onSuccessful() {
        // Cerrar sesión exitosamente, puede avanzar a la siguiente pantalla
    }

    override fun onError(errorCode: String?) {
        // Mostrar mensaje de error en el cierre de sesión
    }
})

En este ejemplo, la función logout se utiliza para cerrar la sesión de un usuario en Pagando Check². La lógica de la aplicación maneja diferentes escenarios después del cierre de sesión, como avanzar a la siguiente pantalla en caso de éxito o mostrar un mensaje de error en caso de falla.