Consultar reporte de transacciones

En esta sección se proporciona información detallada sobre cómo realizar la consulta de reporte de transacciones.

Requisitos

Filtros para aplicar en la búsqueda.

Paso a paso

Instanciar el objeto TrxData pasándole el contexto.
Instanciar el objeto BatchCloseRequest
Invocar el método getBatchClose y pasarle el objeto BatchCloseRequest.
Configurar un observer para recibir el reporte.

Instanciar objeto BatchCloseRequest

Campo	Descripción
appVersion	String opcional. con la versión de la App. Por default se envía un String EMPTY = “”.
transactionType	String obligatorio. String con el tipo de operación que se desea consultar.
merchantId	String obligatorio. Identificador del merchant. Formato UUID.
customerId	String obligatorio. Identificador del customer. Formato UUID.
start	String obligatorio. Fecha de inicio de consulta. Formato UTC+0: YYYY-MM-DDT00:00:00Z
end	String obligatorio. Fecha de fin de consulta. Formato UTC+0: YYYY-MM-DDT00:00:00Z
currency	String obligatorio. Código de moneda.
status	String opcional. Estado de la transacción: APPROVED, REJECTED
paymentMethod	String opcional. Método de pago: DEBIT, CREDIT, PREPAID, QR
cardBrand	Listado opcional. Marca de la tarjeta con la que se realizó la transacción: Para Argentina: VISA, MASTERCARD, MAESTRO. Para México: VISA, MASTERCARD, AMEX, CARNET.
minAmount	String opcional. Monto mínimo para buscar la transacción. En formato ISO, sin punto decimal y los 2 últimos dígitos son los decimales, ejemplo: $10 = 1000
maxAmount	String opcional. Monto máximo para buscar la transacción. En formato ISO, sin punto decimal y los 2 últimos dígitos son los decimales, ejemplo: $10 = 1000

ℹ️

Si no se desea aplicar alguno de estos filtros opcionales, debe enviarse como null.

Ejemplo de implementación

    val trxData = TrxData(context = this)
    val batchCloseRequest = BatchCloseRequest(
        appVersion = "",
        transactionType = "",
        merchantId = merchantId,
        customerId = customerId,
        userEmail = null,
        start = "2025-04-24T00:00:00Z",
        end = "2025-04-25T23:59:00Z",
        currency = CURRENCY_LABEL_ARG,
    )
    trxData.getBatchClose(batchCloseRequest = batchCloseRequest)
    trxData.getBatchClose.observe(this) { lisTrx ->
        isLoading.value = false
        lisTrx?.let {
            Log.i(TAG, "Transaccions report response: $lisTrx")
            message+= "# de pagos: ${lisTrx.count_batch_payment} \n"
            message+= "Total de pagos: $ ${ StringUtils.toStringThousandAmount(lisTrx.total_batch_payment)} \n\n"
 
            message+= "# de devoluciones: ${lisTrx.count_batch_refund} \n"
            message+= "Total de devoluciones: $ ${ StringUtils.toStringThousandAmount(lisTrx.total_batch_refund)} \n"
 
        } ?: run {
            Log.i(TAG, "Transacciones no disponibles")
        }
    }

Datos de respuesta

La respuesta se recupera del objeto TransactionBatchClose.

Objeto TransactionBatchClose

count_batch_payment: Campo de tipo Int, contiene el número total de pagos realizados según el filtro aplicado.
count_batch_refund: Campo de tipo Int, contiene el número total de las devoluciones realizadas según el filtro aplicado.
count_batch_annulment: Campo de tipo Int, contiene el número total de anulaciones realizadas según el filtro aplicado.
total_batch_payment: Campo de tipo Int, contiene el monto total de pagos realizados según el filtro aplicado.
total_batch_refund: Campo de tipo Int, contiene el monto total de las devoluciones realizadas según el filtro aplicado.
total_batch_annulment: Campo de tipo Int, contiene el monto total de anulaciones realizadas según el filtro aplicado.
total_batch_tip: Campo de tipo Int, contiene el monto total de propinas según el filtro aplicado.
total: Campo de tipo Int, contiene el monto total según el filtro aplicado.

ℹ️

Todos los montos están en formato ISO. Es decir, sin separadores de decimales y miles. Los 2 últimos digitos son los decimales.

Realizar una anulación o devolución Funcionamiento de reversas