Obtener Organizaciones
La función getOrganizations
de checkServices
se utiliza para recuperar una lista de organizaciones, incluyendo detalles como su identificador, nombre, categoría y logo. Esta información es esencial para operaciones donde se necesita mostrar o utilizar datos de múltiples organizaciones.
Uso de la Función getOrganizations
Esta función no toma parámetros directos y utiliza un callback, GetOrganizationsCallback
, para manejar la respuesta.
Callback: GetOrganizationsCallback
- Descripción: Callback utilizado para recibir los resultados de la solicitud de organizaciones.
- Métodos:
onSuccessful
: Este método se invoca cuando se recuperan exitosamente las organizaciones.- Valores:
response
(GetOrganizationsResponse
): Contiene la lista de organizaciones y sus detalles.
- Descripción: Se llama cuando se obtienen exitosamente las organizaciones.
- Valores:
onError
: Este método se invoca cuando ocurre un error durante la solicitud de las organizaciones.- Valores:
error
(ErrorResponse): Un código y mensaje de error opcional que describe el fallo.code
código de errormessage
mensaje de error
- Descripción: Se llama cuando hay un error en el proceso de obtener las organizaciones.
- Retorno: Registra un mensaje de error con el código proporcionado.
- Valores:
Datos de la Respuesta (GetOrganizationsResponse
)
La respuesta GetOrganizationsResponse
incluye listas de detalles para cada organización:
id
(List<String>): Identificadores únicos de las organizaciones.name
(List<String>): Nombres de las organizaciones.category
(List<String>): Categorías a las que pertenecen las organizaciones.logo
(List<String>): URLs o datos de los logos de las organizaciones.
checkServices.getOrganizations(object: GetOrganizationsCallback.Stub() {
override fun onSuccessful(response: GetOrganizationsResponse) {
Log.d("SUCCESS", "Organizaciones obtenidas")
// Actualiza el estado con la lista de organizaciones
}
override fun onError(error: ErrorResponse) {
Log.e("getOrganizations", error.code)
}
})
CheckServices checkServices = CheckServices.getInstance(this);
checkServices.getOrganizations(new GetOrganizationsCallback.Stub() {
@Override
public void onSuccessful(GetOrganizationsResponse GetOrganizationsResponse) {
// Success
}
@Override
public void onError(ErrorResponse error) {
Log.d("getOrganizations", error.code );
}
});
Cambiar de organización
La función changeOrganization
Permite a los usuarios de Pagando Check acceder a sus distintas organizaciones y poder cambiar la terminal a alguna de ellas.
Parámetros
profile
:String
- Descripción: identificador unico de organización
Callback: ChangeOrganizationCallback
- 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 cambio de organización es exitoso.- Descripción: Se llama cuando el cambio de organización se completa exitosamente.
- Retorno: No retorna un valor, pero indica que el proceso de cambio de organización fue exitoso.
onError
: Este método se invoca cuando ocurre un error durante el intento de cambio de organización.- Parámetros:
error
(ErrorResponse): Un código y mensaje de error opcional que describe el fallo.code
código de errormessage
mensaje de error
- Descripción: Se llama cuando hay un error en el proceso de cambio de organización.
- Retorno: No retorna un valor, pero proporciona información sobre el error ocurrido.
- Parámetros:
checkServices.changeOrganization(profile = profile, object: ChangeOrganizationCallback.Stub(){
override fun onSuccessful() {
// Cambio de organización exitoso
}
override fun onError(error: ErrorResponse) {
Log.e("changeOrganization", error.code)
}
})
CheckServices checkServices = CheckServices.getInstance(this);
checkServices.changeOrganization(profile, new ChangeOrganizationCallback.Stub() {
@Override
public void onSuccessful() {
// Success
}
@Override
public void onError(ErrorResponse error) {
Log.d("changeOrganization", error.code );
}
});
Movimientos o transacciones
La función organizationTransaction
se utiliza para obtener un historial de transacciones basado en ciertos criterios de búsqueda y filtros. La función luego utiliza un callback para manejar las respuestas recibidas del servicio.
Parámetros
currentPage
: La página actual que se está consultando en el paginado de resultados.perPage
: La cantidad de resultados por página.search
: Un término de búsqueda para filtrar las transacciones.filters
: Criterios adicionales de filtrado para aplicar a la consulta de transacciones.
Callback: OrganizationTransactionCallBack
Descripción: Callback utilizado para recibir los resultados de la solicitud de transacciones por organización
- Métodos:
onError
: Se invoca cuando ocurre un error en la solicitud de transacción.- Parámetros:
error
(ErrorResponse): Un código y mensaje de error opcional que describe el fallo.code
código de errormessage
mensaje de error
- Descripción: Se llama cuando hay un error en el proceso de obtener transacciones por organización
- Retorno: Se debe implementar el manejo del error.
- Parámetros:
onSuccessful
: Este método se invoca cuando se obtiene exitosamente el listado de transacciones por organización- Parámetros:
transactionList
(PaymentHistoryResponse
?): Contiene la lista paginada de cortes y la información de paginación.
- Descripción: Se llama cuando se obtienen exitosamente los cortes de terminal.
- Retorno: Actualiza el estado con la lista de cortes y la información de paginación.
- Parámetros:
Datos de la Respuesta (PaymentHistoryResponse
)
La respuesta PaymentHistoryResponse
incluye:
status
: List<String>Indica el estado de cada pago (aprobado, rechazado, etc.).statusDescription
: List<String> Descripciones detalladas de los estados de los pagos.folio
: List<String> Identificadores únicos para cada transacción.operationDevice
: List<String> Dispositivos utilizados para realizar las transacciones.operationType
: List<String>Tipos de operaciones realizadas (compra, reembolso, etc.).transactionAmount
: List<String> Montos involucrados en cada transacción.cardType
: List<String> Tipos de tarjetas utilizadas (débito, crédito, etc.).lastFour
: List<String> Últimos cuatro dígitos de las tarjetas utilizadas.transactionTime
: List<String> Fecha y hora de cada transacción.paymentType
: List<String> Indica si la transacción fue con crédito o débito.subtotal
: List<String> Subtotal de la compra antes de impuestos o propinas.tipAmount
: List<String> Monto de la propina agregada a la transacción.hasNext
: booleannextPage
: String
fun transactions(currentPage: String, perPage: String, search: String, filters: String) {
val checkServices: CheckServices = CheckServices.getInstance(context)
viewModelScope.launch {
checkServices.organizationTransaction(currentPage,perPage, search, filters, object : OrganizationTransactionCallBack.Stub() {
override fun onSuccessful(PaymentHistoryResponse: PaymentHistoryResponse?) {
Log.d("SUCCESS", "Transacciones obtenidas")
// Actualiza el estado con la lista de transacciones obtenidas
_transaction.value = PaymentHistoryResponse
}
override fun onError(error: ErrorResponse) {
Log.e("organizationTransaction", error.code)
}
})
}
}
CheckServices checkServices = CheckServices.getInstance(this);
checkServices.organizationTransaction(currentPage, perPage, search, filters, new OrganizationTransactionCallBack.Stub() {
@Override
public void onSuccessful(PaymentHistoryResponse response) {
// Success
}
@Override
public void onError(ErrorResponse error) {
Log.d("organizationTransaction", error.code );
}
});