Procesamiento de Operaciones

Diagrama de flujo de venta normal

Funciones generales

Obtener Operaciones u operativas (Get Operations)

La función getOperations recupera una lista de operaciones o servicios disponibles que la terminal de Pagando Check² puede realizar.

Uso

Este método se debe invocar cuando se necesita obtener la lista actualizada de operaciones que la terminal puede realizar.

Callback: GetOperationsCallback

• Descripción: Callback utilizado para recibir los resultados de la solicitud de operaciones disponibles.
• Métodos:
  • onSuccessful: Este método se invoca cuando se recupera exitosamente la lista de operaciones.
    • Parámetros:
      • terminalOperations (List<String>?): Una lista de cadenas que representan las operaciones disponibles en la terminal.
    • Descripción: Se llama cuando se obtiene exitosamente la lista de operaciones disponibles en la terminal.
    • Retorno: No retorna un valor, pero proporciona la lista de operaciones disponibles.
  • onError: Este método se invoca cuando ocurre un error durante la solicitud de operaciones.
    • 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 obtener las operaciones disponibles.
    • Retorno: No retorna un valor, pero proporciona información sobre el error ocurrido.

fun getOperations() {
    checkServices.getOperations(
        object : GetOperationsCallback.Stub() {
            override fun onSuccessful(terminalOperations: List<String>?) {
                // Lógica a seguir cuando se obtiene la lista de operaciones
                Log.i("Client.getOperations", Gson().toJson(terminalOperations))
            }

           override fun onError(error: ErrorResponse) {
              Log.e("getOperations", error.code)
          }
        }
    )
}

fun getOperations() {
    checkServices.getOperations(
        object : GetOperationsCallback.Stub() {
            override fun onSuccessful(terminalOperations: List<String>?) {
                // Lógica a seguir cuando se obtiene la lista de operaciones
                Log.i("Client.getOperations", Gson().toJson(terminalOperations))
            }

           override fun onError(error: ErrorResponse) {
              Log.e("getOperations", error.code)
          }
        }
    )
}

        CheckServices checkServices = CheckServices.getInstance(this);

            checkServices.getOperations(new GetOperationsCallback.Stub() {
                @Override
                public void onSuccessful(List<String> terminalOperations) {
									// Success
                }

		            @Override
		            public void onError(ErrorResponse error) {
		                Log.d("getOperations", error.code );
		            }
            });

        CheckServices checkServices = CheckServices.getInstance(this);

            checkServices.getOperations(new GetOperationsCallback.Stub() {
                @Override
                public void onSuccessful(List<String> terminalOperations) {
									// Success
                }

		            @Override
		            public void onError(ErrorResponse error) {
		                Log.d("getOperations", error.code );
		            }
            });

Listado de Operativas

Leer Tarjeta

La función readCard se utiliza para leer la información de una tarjeta 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.

Nota: Requiere inicialización de llaves

Parámetros

• nipPagandoView: NipPagandoView
  • Descripción: La vista utilizada para procesar y mostrar el NIP (Número de Identificación Personal) en la interfaz de usuario.
  • Ejemplo: nipPagandoView
• amount: Double
  • Descripción: El monto asociado a la transacción actual.
  • Ejemplo: amount.value
• terminalOperation: TerminalOperation
  • Descripción: La operación terminal asociada a la transacción actual (por ejemplo: SALE, SELL, SALE_TIP, CANCEL, REFUND, etc.).
  • Ejemplo: _terminalOperation.value

Callback: ReadCardCallback

• Descripción: Callback utilizado para recibir los resultados de la lectura de la tarjeta.
• Métodos:
  • onError: Este método se invoca cuando ocurre un error durante la lectura de la tarjeta.
    • 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 lectura de la tarjeta.
    • Retorno: No retorna un valor, pero proporciona información sobre el error ocurrido.
  • onSuccessful: Este método se invoca cuando la lectura de la tarjeta se completa exitosamente.
    • Parámetros:
      • typeCard (Int): El tipo de tarjeta leído.
    • Descripción: Se llama cuando la lectura de la tarjeta se ha completado satisfactoriamente.
    • Retorno: No retorna un valor, pero proporciona información sobre la tarjeta leída.
  • onMessage: Este método se invoca para proporcionar mensajes informativos durante el proceso de lectura de la tarjeta.
    • Parámetros:
      • message (String): El mensaje informativo.
    • Descripción: Se llama para proporcionar información adicional o mensajes durante la lectura de la tarjeta.
    • Retorno: No retorna un valor, pero proporciona información adicional.
  • onActionNip:
    • Parámetros:
      • message (String): Mensaje relacionado con la captura del NIP.
      • callback (ActionNipCallback): Callback utilizado para manejar las acciones relacionadas con el NIP.
    • Descripción: Se invoca cuando la tarjeta requiere que el usuario ingrese el NIP. Este método permite manejar las siguientes acciones mediante el ActionNipCallback:
      • onCancel(): Se invoca cuando el usuario cancela el ingreso del NIP.
      • onSetPin(pin: String): Se invoca cuando el usuario ingresa el NIP y este es enviado para su validación.
    • Retorno: No retorna un valor, pero proporciona una interacción directa con el ingreso del NIP.
  • onApplicationSelection: Este método se invoca cuando es necesario que el usuario seleccione una aplicación específica (existen tarjetas con varios métodos de entrada).
    • Parámetros:
      • apps (Array<String>): Arreglo de nombres de aplicaciones entre las cuales el usuario debe seleccionar.
      • selectAppCallback (SelectAppCallback): Callback para manejar la selección de la aplicación.
    • Descripción: Se llama cuando es necesario que el usuario seleccione una aplicación específica de la tarjeta.
    • Retorno: No retorna un valor, pero indica que se espera la selección de una aplicació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(App.appContext)

/*
Llamada de la función readCard que responde con un
ReadCardCallback que podría tener varios métodos,
incluyendo onError, onSuccessful, onMessage,
onActionNip y onApplicationSelection.
*/
checkServices.readCard(
    nipPagandoView,
    amount.value,
    _terminalOperation.value.name,
    object : ReadCardCallback.Stub() {
         override fun onError(error: ErrorResponse) {
            Log.e("readCard", error.code)
        }
        override fun onSuccessful(typeCard: Int) {
            _readCardMessage.value = "Puede retirar su tarjeta."
            when (_terminalOperation.value) {
                SALE, SELL, SALE_TIP, CANCEL, REFUND, CHECK_IN, CHECK_OUT, REAUTHORIZATION,
                PRE_SALE, PRE_SALE_CLOSING, REVERSE, QPS -> makePayment(callback)

                DEFERRED_PAYMENT -> getPromotions(callback)
            }
        }

        override fun onMessage(message: String) {
            _readCardMessage.value = message
        }

        override fun onActionNip(message: String?, callback: ActionNipCallback?) {
            nipPagandoView.proccessMessage(message)
            callback?.onSetPin("1234") // Ejemplo de envío de NIP
        }

        override fun onApplicationSelection(
            apps: Array<String>?,
            selectAppCallback: SelectAppCallback?
        ) {
            MainActivity.instance!!.runOnUiThread {
                AlertDialog.Builder(MainActivity.instance)
                    .setTitle("Select Application")
                    .setCancelable(false)
                    .setNegativeButton(
                        "Cancel"
                    ) { dialog, which ->
                        dialog.dismiss()
                        selectAppCallback!!.cancel()
                    }
                    .setItems(apps) { dialog, which ->
                        dialog.dismiss()
                        selectAppCallback!!.selectApp(which)
                    }
                    .show()
            }
        }
    })

/*
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 readCard que responde con un
ReadCardCallback que podría tener varios métodos,
incluyendo onError, onSuccessful, onMessage,
onActionNip y onApplicationSelection.
*/
checkServices.readCard(
    nipPagandoView,
    amount.value,
    _terminalOperation.value.name,
    object : ReadCardCallback.Stub() {
         override fun onError(error: ErrorResponse) {
            Log.e("readCard", error.code)
        }
        override fun onSuccessful(typeCard: Int) {
            _readCardMessage.value = "Puede retirar su tarjeta."
            when (_terminalOperation.value) {
                SALE, SELL, SALE_TIP, CANCEL, REFUND, CHECK_IN, CHECK_OUT, REAUTHORIZATION,
                PRE_SALE, PRE_SALE_CLOSING, REVERSE, QPS -> makePayment(callback)

                DEFERRED_PAYMENT -> getPromotions(callback)
            }
        }

        override fun onMessage(message: String) {
            _readCardMessage.value = message
        }

        override fun onActionNip(message: String?, callback: ActionNipCallback?) {
            nipPagandoView.proccessMessage(message)
            callback?.onSetPin("1234") // Ejemplo de envío de NIP
        }

        override fun onApplicationSelection(
            apps: Array<String>?,
            selectAppCallback: SelectAppCallback?
        ) {
            MainActivity.instance!!.runOnUiThread {
                AlertDialog.Builder(MainActivity.instance)
                    .setTitle("Select Application")
                    .setCancelable(false)
                    .setNegativeButton(
                        "Cancel"
                    ) { dialog, which ->
                        dialog.dismiss()
                        selectAppCallback!!.cancel()
                    }
                    .setItems(apps) { dialog, which ->
                        dialog.dismiss()
                        selectAppCallback!!.selectApp(which)
                    }
                    .show()
            }
        }
    })

        CheckServices checkServices = CheckServices.getInstance(this);
        checkServices.readCard(nipPagandoView, amount, operationType, new ReadCardCallback.Stub() {
	          @Override
            public void onError(ErrorResponse error) {
                Log.d("readCard", error.code );
            }

            @Override
            public void onSuccessful(int typeCard) {
								// Success

            }

            @Override
            public void onMessage(String message) {
								Log.d("Message:", message)
            }

            @Override
            public void onActionNip(String message) {
                nipPagandoView.proccessMessage(message);
            }

            @Override
            public void onApplicationSelection(String[] apps, SelectAppCallback selectAppCallback) {
                ReadCardView.this.runOnUiThread(() ->  new AlertDialog.Builder(ReadCardView.this)
                        .setTitle("Select Application")
                        .setCancelable(false)
                        .setNegativeButton("Cancel", (dialog, which) -> dialog.dismiss())
                        .setItems(apps, (dialog, which) -> dialog.dismiss())
                        .show());
            }
        });

        CheckServices checkServices = CheckServices.getInstance(this);
        checkServices.readCard(nipPagandoView, amount, operationType, new ReadCardCallback.Stub() {
	          @Override
            public void onError(ErrorResponse error) {
                Log.d("readCard", error.code );
            }

            @Override
            public void onSuccessful(int typeCard) {
								// Success

            }

            @Override
            public void onMessage(String message) {
								Log.d("Message:", message)
            }

            @Override
            public void onActionNip(String message) {
                nipPagandoView.proccessMessage(message);
            }

            @Override
            public void onApplicationSelection(String[] apps, SelectAppCallback selectAppCallback) {
                ReadCardView.this.runOnUiThread(() ->  new AlertDialog.Builder(ReadCardView.this)
                        .setTitle("Select Application")
                        .setCancelable(false)
                        .setNegativeButton("Cancel", (dialog, which) -> dialog.dismiss())
                        .setItems(apps, (dialog, which) -> dialog.dismiss())
                        .show());
            }
        });

Marca de la tarjeta

La función getCardBrand se utiliza para obtener datos necesarios para el proceso de compra, como lo son datos específicos de la tarjeta y token en potencia

Callback GetCardBrandCallback :

Descripción Callback: Callback utilizado para recibir datos de la tarjeta

• Metodos:
  • OnSuccessful
    • brand marca de la tarjeta
    • BIN Numero de identificación
    • accountingNature Naturaleza de la cuenta
    • idempotencyToken token de identificación en potencia
  • OnError
    • 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

                   val checkServices: CheckServices = CheckServices.getInstance(App.appContext)
                    checkServices.getCardBrand(object: GetCardBrandCallback.Stub() {
                        override fun onSuccessful(cardBrand: CardBrand?) {
															// Datos de la tarjeta
                        }

                        override fun onError(errorResponse: ErrorResponse?) {
			                       // Manejo de error
                        }
                    })

                   val checkServices: CheckServices = CheckServices.getInstance(App.appContext)
                    checkServices.getCardBrand(object: GetCardBrandCallback.Stub() {
                        override fun onSuccessful(cardBrand: CardBrand?) {
															// Datos de la tarjeta
                        }

                        override fun onError(errorResponse: ErrorResponse?) {
			                       // Manejo de error
                        }
                    })

CheckServices checkServices = CheckServices.getInstance(App.getAppContext());
checkServices.getCardBrand(new GetCardBrandCallback.Stub() {
    @Override
    public void onSuccessful(CardBrand cardBrand) {
        // Datos de la tarjeta
    }

    @Override
    public void onError(ErrorResponse errorResponse) {
        // Manejo de error
    }
});

CheckServices checkServices = CheckServices.getInstance(App.getAppContext());
checkServices.getCardBrand(new GetCardBrandCallback.Stub() {
    @Override
    public void onSuccessful(CardBrand cardBrand) {
        // Datos de la tarjeta
    }

    @Override
    public void onError(ErrorResponse errorResponse) {
        // Manejo de error
    }
});

Marca de la tarjeta con Referencia externa

La función getCardBrandCR se utiliza para obtener datos necesarios para el proceso de compra, como lo son datos específicos de la tarjeta y token en potencia

Parámetros

commerceReference: String – Referencia externa de comercio

Callback GetCardBrandCallback :

Descripción Callback: Callback utilizado para recibir datos de la tarjeta

• Metodos:
  • OnSuccessful
    • brand marca de la tarjeta
    • BIN Numero de identificación
    • accountingNature Naturaleza de la cuenta
    • idempotencyToken token de identificación en potencia
  • OnError
    • 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

                   val checkServices: CheckServices = CheckServices.getInstance(App.appContext)
                    checkServices.getCardBrandCR(commerceReference ,object: GetCardBrandCallback.Stub() {
                        override fun onSuccessful(cardBrand: CardBrand?) {
															// Datos de la tarjeta
                        }

                        override fun onError(errorResponse: ErrorResponse?) {
			                       // Manejo de error
                        }
                    })

                   val checkServices: CheckServices = CheckServices.getInstance(App.appContext)
                    checkServices.getCardBrandCR(commerceReference ,object: GetCardBrandCallback.Stub() {
                        override fun onSuccessful(cardBrand: CardBrand?) {
															// Datos de la tarjeta
                        }

                        override fun onError(errorResponse: ErrorResponse?) {
			                       // Manejo de error
                        }
                    })

Estado del token

La función getTokenInPotency se utiliza para obtener el estado y detalles de un token específico dentro de la aplicación.

Parámetros

• token (String): El token que se desea consultar en el sistema.

Callback TokenStatusCallback :

• Descripción: Callback utilizado para recibir los resultados de la consulta del token.
• Metodos
  • OnSuccessful
    • Parametros:
      • status (String)
      • order(TokenStatusOrder)
        • folio folio de la transacción
        • authCode código de autorización
        • currency moneda
        • cardBrand Marca de la tarjeta
        • operationStatus Estado de la operación
        • accountType Tipo de cuenta
        • concept Concepto
        • created_at fecha de creación
        • amount Cantidad
        • last4 Ultimos 4 dígitos de la tarjeta
        • emvType tipo de emv
        • isRecurrentPaymet Es pago recurrente
        • opeationType Tipo de operación
        • responseCode Código de respuesta
        • responseDescription Descripción de la respuesta
    • Funcionalidad: Se llama cuando la consulta del token se completa exitosamente, proporcionando estado y detalles asociados.
    • Retorno: No tiene retorno
  • OnError
    • 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

/*
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 getTokenInPotency que recibe un token como parámetro.
Responde a un TokenStatusCallback que incluye dos métodos: onSuccessful y onError.
*/
checkServices.getTokenInPotency(token, object : TokenStatusCallback.Stub() {
    // Método que se invoca cuando la consulta del token se completa exitosamente
    override fun onSuccessful(status: String?, order: TokenStatusOrder?) {
		   // Obtiene status del token
    }

    // Método que se invoca cuando hay un error en la consulta del token
    override fun onError(error: ErrorResponse) {
        // Responde un error
    }
})

/*
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 getTokenInPotency que recibe un token como parámetro.
Responde a un TokenStatusCallback que incluye dos métodos: onSuccessful y onError.
*/
checkServices.getTokenInPotency(token, object : TokenStatusCallback.Stub() {
    // Método que se invoca cuando la consulta del token se completa exitosamente
    override fun onSuccessful(status: String?, order: TokenStatusOrder?) {
		   // Obtiene status del token
    }

    // Método que se invoca cuando hay un error en la consulta del token
    override fun onError(error: ErrorResponse) {
        // Responde un error
    }
})

Realizar Pago

La función makePayment se utiliza para iniciar el proceso de pago a través del dispositivo de Pagando Check². Esta función es esencial para completar transacciones que implican la transferencia de fondos, validación de tarjetas y aplicación de promociones si están disponibles.

Nota: Requiere inicialización de llaves

Parámetros

• callback: (String) -> Unit
  • Descripción: Un callback que se invoca con una ruta de navegación dependiendo del resultado del proceso de pago.

Callback: MakePaymentCallback

• Descripción: Callback utilizado para recibir los eventos y estados durante el proceso de pago.
• Métodos:
  • onError: Este método se invoca cuando ocurre un error durante el proceso de pago.
    • Valores:
      • 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 pago.
    • Retorno: Actualiza el estado de _message con el código de error.
  • onPaymentSuccess: Este método se invoca cuando el pago se completa exitosamente.
    • Valores:
      • paymentResponse (PaymentResponse?): Contiene los detalles del pago realizado.
    • Descripción: Se llama cuando el pago se realiza exitosamente.
    • Retorno: Actualiza el estado de _paymentResponse y _message con los detalles del pago exitoso y utiliza el callback para navegar a la pantalla de impresión de ticket.
  • onSignatureRequired: Este método se invoca cuando se requiere la firma del cliente para completar el pago.
    • Descripción: Se llama cuando el proceso de pago requiere la firma del cliente.
    • Retorno: Actualiza el estado de _message con un mensaje indicando que se requiere firma y utiliza el callback para navegar a la pantalla de firma.

fun makePayment(callback: (String) -> Unit) {
        val checkServices: CheckServices = CheckServices.getInstance(context)
        checkServices.makePayment(
            object : MakePaymentCallback.Stub() {
				         override fun onError(error: ErrorResponse) {
				            Log.e("makePayment", error.code)
				        }

                override fun onPaymentSuccess(paymentResponse: PaymentResponse?) {
                    _paymentResponse.value = paymentResponse!!
                    _message.value = "Pago exitoso: " + paymentResponse.folio
                    callback(NavRoutes.salePrintTicketView.route)
                }

                override fun onSignatureRequired() {
                    _message.value = "Requiere firma: abrir pantalla para dibujar firma"
                    callback(NavRoutes.saleSignatureView.route)
                }
            })
    }

fun makePayment(callback: (String) -> Unit) {
        val checkServices: CheckServices = CheckServices.getInstance(context)
        checkServices.makePayment(
            object : MakePaymentCallback.Stub() {
				         override fun onError(error: ErrorResponse) {
				            Log.e("makePayment", error.code)
				        }

                override fun onPaymentSuccess(paymentResponse: PaymentResponse?) {
                    _paymentResponse.value = paymentResponse!!
                    _message.value = "Pago exitoso: " + paymentResponse.folio
                    callback(NavRoutes.salePrintTicketView.route)
                }

                override fun onSignatureRequired() {
                    _message.value = "Requiere firma: abrir pantalla para dibujar firma"
                    callback(NavRoutes.saleSignatureView.route)
                }
            })
    }

El modelo PaymentResponse encapsula los detalles y el estado de una transacción de pago. A continuación, se documentan las propiedades de este modelo:

Propiedades

• responseCode (String): Código que indica el resultado de la transacción.
• description (String): Descripción textual del resultado de la transacción.
• accountType (String): Tipo de cuenta asociada con la tarjeta.
• ARQC (String): Cryptograma de solicitud de autorización (Authorization Request Cryptogram).
• AID (String): Identificador de la aplicación de la tarjeta (Application Identifier).
• last4 (String): Últimos cuatro dígitos del número de la tarjeta.
• brand (String): Marca comercial asociada con la tarjeta o transacción.
• folio (String): Folio único de la transacción.
• amount (String): Importe por el que se realizó la transacción
• transactionTime (String): Fecha y hora de la transacción.
• pinEntry (boolean): Identifica si para la transacción fue introducido el PIN de verificación de la tarjeta
• emvType (String): Identifica el tipo de lector de tarjeta que se utilizo al procesar la transacción.
• requireSignature (boolean): Indica si la transacción requiere firma del cliente.
• authCode (String): Código de autorización generado por la entidad emisora de la tarjeta.
• traceNumber (String): Número de seguimiento de la transacción.
• retrievalReference (String): Número de referencia para la recuperación de la
• status (String): Estado de la transacción.
• mustReloadKeyNow (boolean): Indica si es necesario recargar la clave inmediatamente.
• mustReloadKeySoon (boolean): Indica si será necesario recargar la clave pronto.
• employee (String): Identificador del empleado que realizó o gestionó la transacción.
• merchantIdCode (String): Número de identificación único del comercio (Afiliación Bancaria)
• tipAmount (Double): Cuanto fue agregado de propina.
• operationType (String): Tipo de operación realizada.

Establecer Firma

La función setSignature se utiliza para enviar la firma digital capturada del cliente a los servicios de Pagando Check² como parte del proceso de finalización de una transacción. Esta firma es crucial para confirmar la autorización de la transacción por parte del cliente.

Parámetros

• base64String: String
  • Descripción: La firma del cliente codificada en base64.
  • Ejemplo: "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...=="
• callback: () -> Unit = {}
  • Descripción: Un callback opcional que se invoca después de que la firma ha sido enviada y procesada exitosamente.
  • Valor por defecto: Un callback vacío, indicando que no hay acciones adicionales a realizar después del proceso.

Callback: SignatureCallback

• Descripción: Callback utilizado para recibir los eventos y estados durante el proceso de envío de la firma.
• Métodos:
  • onError: Este método se invoca cuando ocurre un error durante el proceso de envío de la firma.
    • 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 envío de la firma.
    • Retorno: Actualiza el estado de _message con el código de error.

        val checkServices: CheckServices = CheckServices.getInstance(App.appContext)
        checkServices.setSignature(base64String,
            object : SignatureCallback.Stub() {
				         override fun onError(error: ErrorResponse) {
				            Log.e("setSignature", error.code)
				        }

                override fun onSuccessful(paymentResponse: PaymentResponse?) {
										// Success
                    callback()
                }
            })

        val checkServices: CheckServices = CheckServices.getInstance(App.appContext)
        checkServices.setSignature(base64String,
            object : SignatureCallback.Stub() {
				         override fun onError(error: ErrorResponse) {
				            Log.e("setSignature", error.code)
				        }

                override fun onSuccessful(paymentResponse: PaymentResponse?) {
										// Success
                    callback()
                }
            })

      CheckServices checkServices = CheckServices.getInstance(this);
			
			checkServices.setSignature(bitmap, new SignatureCallback.Stub() {
                @Override
		            public void onError(ErrorResponse error) {
		                Log.d("setSignature", error.code );
		            }

                @Override
                public void onSuccessful(PaymentResponse paymentResponse) {
                    // Success
                }
            });

      CheckServices checkServices = CheckServices.getInstance(this);
			
			checkServices.setSignature(bitmap, new SignatureCallback.Stub() {
                @Override
		            public void onError(ErrorResponse error) {
		                Log.d("setSignature", error.code );
		            }

                @Override
                public void onSuccessful(PaymentResponse paymentResponse) {
                    // Success
                }
            });

Obtener Detalles de Transacción por Folio

La función getOperationByFolio se utiliza para recuperar información detallada de una transacción específica mediante su folio. Es crucial para realizar seguimientos y validaciones de transacciones individuales.

Parámetros

• folio: String
  • Descripción: El identificador único de la transacción que se desea recuperar.
  • Ejemplo: "FOL123456789"
• context: Context
  • Descripción: El contexto actual de la aplicación. Se utiliza para acceder a recursos y datos específicos del entorno de la aplicación.

Callback: TransactionByFolioCallback

• Descripción: Callback utilizado para recibir los detalles de la transacción solicitada.
• Métodos:
  • onSuccessful: Este método se invoca cuando la información de la transacción se recupera exitosamente.
    • Valores:
      • paymentResponse (TransactionFolioResponse?): Contiene los detalles de la transacción recuperada, incluyendo:
        • accountType (String): Tipo de cuenta asociada con la tarjeta.
        • ARQC (String): Cryptograma de solicitud de autorización (Authorization Request Cryptogram).
        • AID (String): Identificador de la aplicación de la tarjeta (Application Identifier).
        • BIN (String): Bin de la tarjeta que realizó la operación a 6 dígitos
        • BIN8 (String): Bin de la tarjeta que realizó la operación a 8 dígitos
        • last4 (String): Últimos cuatro dígitos del número de la tarjeta.
        • brand (String): Marca comercial asociada con la tarjeta o transacción.
        • folio (String): Folio único de la transacción.
        • amount (String): Importe por el que se realizó la transacción.
        • status (String): Estado de la transacción.
        • emvType (String): Identifica el tipo de lector de tarjeta que se utilizo al procesar la transacción.
        • authCode (String): Código de autorización generado por la entidad emisora de la tarjeta.
        • pinEntry (boolean): Identifica si para la transacción fue introducido el PIN de verificación de la tarjeta
        • description (String): Descripción textual del resultado de la transacción.
        • merchantIdCode (String): Número de identificación único del comercio (Afiliación Bancaria)
        • transactionTime (String): Fecha y hora de la transacción.
        • requireSignature (boolean): Indica si la transacción requiere firma del cliente.
        • operationType (String): Tipo de operación realizada.
    • Descripción: Se llama cuando se obtiene exitosamente la información de la transacción.
  • onError: Este método se invoca cuando ocurre un error durante la solicitud de la transacción.
    • Valores:
      • 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 recuperar la transacción.
    • Retorno: Proporciona información sobre el error ocurrido.

fun getOperatationByFolio(folio: String, context: Context){
        val checkServices: CheckServices = CheckServices.getInstance(context)
        viewModelScope.launch {
            checkServices.transactionByFolio(folio, object: TransactionByFolioCallback.Stub(){
                override fun onSuccessful(paymentResponse: TransactionFolioResponse?) {
                        // Lógica a seguir cuando la petición es exitosa
                }
				         override fun onError(error: ErrorResponse) {
				            Log.e("getOperatationByFolio", error.code)
				        }
            )
        }
    }

fun getOperatationByFolio(folio: String, context: Context){
        val checkServices: CheckServices = CheckServices.getInstance(context)
        viewModelScope.launch {
            checkServices.transactionByFolio(folio, object: TransactionByFolioCallback.Stub(){
                override fun onSuccessful(paymentResponse: TransactionFolioResponse?) {
                        // Lógica a seguir cuando la petición es exitosa
                }
				         override fun onError(error: ErrorResponse) {
				            Log.e("getOperatationByFolio", error.code)
				        }
            )
        }
    }

     CheckServices checkServices = CheckServices.getInstance(this);

						checkServices.transactionByFolio(folio, new TransactionByFolioCallback.Stub() {
                @Override
                public void onSuccessful(TransactionFolioResponse paymentResponse) {
										// Success
                }

                @Override
		            public void onError(ErrorResponse error) {
		                Log.d("transactionByFolio", error.code );
		            }
            });

     CheckServices checkServices = CheckServices.getInstance(this);

						checkServices.transactionByFolio(folio, new TransactionByFolioCallback.Stub() {
                @Override
                public void onSuccessful(TransactionFolioResponse paymentResponse) {
										// Success
                }

                @Override
		            public void onError(ErrorResponse error) {
		                Log.d("transactionByFolio", error.code );
		            }
            });