Terminales
Consultar una transacción

Consultar una transacción

ℹ️

Este proceso es obligatorio

En esta sección se proporciona información detallada sobre cómo realizar consultas sobre transacciones, aplicando diferentes filtros.

Requisitos

  • Filtros para aplicar en la búsqueda.

Paso a paso

  1. Instanciar el objeto TrxData pasándole el objeto.
  2. Instanciar el objeto LastTrxRequest
  3. Invocar el método getLastTrx y pasarle el objeto LastTrxRequest.
  4. Configurar un observer para recibir el listado de transacciones.

Instanciar objeto LastTrxRequest

CampoDescripción
appVersionString con la versión de la App. Por default se envía un String EMPTY = “”.
operationTypeString con el tipo de operación que se desea consultar.
merchantIdIdentificador del merchant. Formato UUID.
customerIdIdentificador del customer. Formato UUID.
startFecha de inicio de consulta. Formato UTC+0: YYYY-MM-DDT00:00:00Z
endFecha de fin de consulta. Formato UTC+0: YYYY-MM-DDT00:00:00Z
pageNúmero de páginas a recuperar.
sizeCantidad de registros a recuperar.
statusEstado de la transacción: APPROVED, REJECTED
paymentMethodMétodo de pago: DEBIT, CREDIT, QR
cardBrand
  • Marca de la tarjeta con la que se realizó la transacción:
  • Para Argentina: VISA, MASTERCARD, MAESTRO.
  • Para México: VISA, MASTERCARD, AMEX, CARNET.
minAmountMonto 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
maxAmountMonto 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, debe enviarse como null.

Ejemplo de implementación

TrxData trxData = new TrxData(getReactApplicationContext().getApplicationContext());
LastTrxRequest lastTrxRequest = new LastTrxRequest(
    "", "ACQUIRER",
    merchantId,
    customerId,
    "",
    "2023-06-27T03:00:00Z",
    "2023-06-28T05:59:00Z",
    0, 1000);
 
trxData.getLastTrx(lastTrxRequest);
TrxObserver trxObserver = new TrxObserver();
LiveData<LastTrxResponse> myLiveData = trxData.getGetLastTrx();
 
Handler handler = new Handler(Looper.getMainLooper()); 
handler.post(new Runnable() { 
        @Override
        public void run() {
            myLiveData.observeForever(trxObserver);
        }
    }
);
 
myLiveData.observeForever(trxObserver);

Códigos de respuesta

La respuesta se recupera del objeto TrxListResponse.

Objeto TrxListResponse

  • statusResult: Campo de tipo StatusResult, contiene el estado de la consulta. En el campo code de este objeto se puede recuperar el estado, los posibles valores son:
CódigoDescripción
StatusResult.ERROROcurrió un error en la búsqueda de las transacciones.
StatusResult.SUCCESSLa consulta se realizó con éxito.
  • content: Campo de tipo List<Transaction>, contiene el listado de transacciones devueltos en la consulta. El objeto Transaction contiene los siguientes datos:
    • id → es el identificador interno de la transacción.
    • type → es el tipo de transacción.
    • merchant_id → es el identificador del merchant con el que se realizó la transacción.
    • customer_id → es el identificador del customer con el que se realizó la transacción.
    • terminal → Contiene datos de la terminal.
    • currency → Es el código de moneda con el que se realizó la transacción.
    • installment → Contiene información de las cuotas, si aplica.
    • amount → Es el monto de la transacción.
    • card → Contiene datos de la tarjeta.
    • qr_id → Es el identificador de QR, aplica para los pagos cno QR.
    • refunded_amount → Contiene el monto de la devolución/anulación.
Realizar un pagoRealizar una anulación o devolución