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 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()
        }
    })

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!!)
        }
    })

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
    }
})

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.