Transacciones - Versión 2.0

Obtener transacciones

`GET /v2/transaction-reports`

Este endpoint permite buscar información impositiva de transacciones por varios criterios. La versión 2.0 del endpoint introduce mejoras significativas en la estructura de la respuesta para proporcionar una interfaz más clara y eficiente.

Parámetros	Descripción
page	integer El número de la página de resultados a obtener (>=0)
size	integer El número de resultados por página (max = 10000)
start (opcional)	date La fecha de inicio del rango de búsqueda. Requiere offset: Z o, por ejemplo, -03:00 (2026-09-30T00:00:00-03:00) [yyyy-MM-ddTHH:mm:ssXXX]
end (opcional)	date La fecha de fin del rango de búsqueda. Requiere offset, igual que start [yyyy-MM-ddTHH:mm:ssXXX]
operationId (opcional)	string Identificador (UUID) de la operación
ticketId (opcional)	integer Número de operación
requestId (opcional)	string Identificador de la solicitud que originó la operación
merchantId (opcional)	array Identificadores (UUID) de comercio para acotar la búsqueda
serialCode (opcional)	string Número de serie de la terminal
acquirerId (opcional)	string Identificador del adquirente
amountFrom (opcional)	string Monto mínimo de la operación
amountTo (opcional)	string Monto máximo de la operación
timeStart (opcional)	string Hora de inicio dentro del día. Formato HH:mm
timeEnd (opcional)	string Hora de fin dentro del día. Formato HH:mm
hint (opcional)	string Texto de búsqueda libre
operationType (opcional)	string El tipo de operación de las transacciones [PAYMENT, REFUND, ANNULMENT]
cardType (opcional)	string Tipo de tarjeta [DEBIT, CREDIT, PREPAID]
cardBrand (opcional)	string Marca de tarjeta [VISA, MASTERCARD, AMEX, CARNET, MAESTRO]
paymentMethod (opcional)	string El método de pago [DEBIT, CREDIT, PREPAID, QR]
status (opcional)	string Un listado de estados de las transacciones [APPROVED, FAILED, REVERSED, PENDING, REJECTED]

ℹ️

start y end son opcionales; se recomienda enviarlos para acotar el período.
status solo acepta los valores indicados; cualquier otro responde 400.
cardType puede usarse como alternativa a paymentMethod.
Un usuario de comercio solo recibe los códigos de impuesto (tax_code) propios del comercio: no incluye los códigos MENTA_*, ACQUIRER_*, CUSTOMER_VAT_TAX ni CUSTOMER_INCOME_TAX. Los impuestos con monto cero o nulo se omiten.

Esquema de la respuesta:

Parámetros	Descripción
customer_id	string ID del cliente
merchant_id	string ID del comercio
terminal_id	string ID de la terminal
merchant_additional_info	string Información adicional del comercio
transaction_id	string ID de la transacción
operation_id	string ID de la operación
operation_number	integer Número de la operación
request_id (opcional)	string Identificador de la solicitud que originó la operación
operation_additional_info	string Información adicional de la operación
serial_number	string Número de serie
operation_type	string Tipo de operación [PAYMENT, REFUND, ANNULMENT]
payment_method	string Método de pago [CREDIT, DEBIT, PREPAID, QR]
gross_amount	number Monto bruto de la operación
currency	string Moneda de la operación [ARS, MEX]
datetime	string Fecha de la operación
status	string Estado de la operación [FAILED, APPROVED, REVERSED, REJECTED]
installments	integer Número de cuotas
financing (opcional)	string Tipo de financiación de cuotas
user	string Usuario que realizó la operación
acquirer	string Adquirente que realizó la operación [PRISMA, GPS, BANORTE, AMEX]
operation_detail	object Detalles adicionales de la operación
tax_info	object Información de impuestos

Esquema del detalle de la operación (operation_detail):

Parámetros	Descripción
operation_detail. reference_operation_id (opcional)	string ID de operación de pago de referencia (solo aplica para REFUND y ANNULMENT)
operation_detail. reference_operation_number (opcional)	integer Número de operación de pago de referencia (solo aplica para REFUND y ANNULMENT)
operation_detail. qr_id (opcional)	string ID del código QR asociado a la transacción
operation_detail. rrn (opcional)	string Número de referencia de la transacción
operation_detail. authorization_code (opcional)	string Código de autorización de la transacción
operation_detail. additional_info (opcional)	string Información adicional sobre la operación
operation_detail. card (opcional)	object Detalles de la tarjeta utilizada en la operación
operation_detail. holder_name (opcional)	string Nombre del titular de la tarjeta
operation_detail. holder_document (opcional)	string Documento de identificación del titular de la tarjeta
operation_detail. description (opcional)	string Descripción de la operación
operation_detail. response_description (opcional)	string Descripción de la respuesta del adquirente
operation_detail. response_code (opcional)	string Código de respuesta del adquirente
operation_detail. response_name (opcional)	string Nombre de la respuesta del adquirente
operation_detail. situation_code (opcional)	string Código de situación de la operación
operation_detail. situation_message (opcional)	string Mensaje de situación de la operación
operation_detail. advance_amount (opcional)	number Monto de adelanto
operation_detail. tip_amount (opcional)	number Monto de las propinas
operation_detail. wallet_name (opcional)	string Nombre de la billetera
operation_detail. input_mode (opcional)	string Método de lectura [CONTACTLESS, EMV, STRIPE]
operation_detail. cvm_method	string Método de verificación de la tarjeta [SIGNATURE, PINONLINE, PINOFFLINE, NOCVM]

Esquema del detalle de la tarjeta (card):

Parámetros	Descripción
operation_detail.card. card_bin (opcional)	string Número bin de la tarjeta
operation_detail.card. card_mask (opcional)	string Número enmascarado de la tarjeta
operation_detail.card. card_brand (opcional)	string Marca de la tarjeta
operation_detail.card. is_international_card (opcional)	boolean Si la tarjeta es internacional

Esquema de la información de impuestos (tax_info):

Parámetros	Descripción
tax_info. term	integer Cantidad de días
tax_info. payment_date	string Fecha de pago [2000-12-31T00:00:00Z]
tax_info. net_amount	number Monto neto
tax_info. customer_term (opcional)	integer Cantidad de días del cliente. Se omite para usuarios de comercio
tax_info. customer_payment_date (opcional)	string Fecha de pago del cliente. Se omite para usuarios de comercio [2000-12-31T00:00:00Z]
tax_info. customer_net_amount (opcional)	number Monto neto del cliente. Se omite para usuarios de comercio
tax_info. tax_breakdown	array Desglose de impuestos

Esquema del desglose de impuestos (tax_breakdown):

Parámetros	Descripción
tax_code	string Código de impuesto
reference	string Descripción del impuesto
amount	number Monto del impuesto
rate (opcional)	number Tasa del impuesto

Códigos de desglose de impuestos (tax_code):

MENTA_TO_CUSTOMER_COMMISSION: Comisión de Menta
MENTA_TO_CUSTOMER_COMMISSION_VAT_TAX: IVA sobre la comisión de Menta
MENTA_DISCOUNT: Descuento de Menta
ACQUIRER_TO_CUSTOMER_COMMISSION: Comisión de la condición comercial
ACQUIRER_TO_CUSTOMER_COMMISSION_VAT_TAX: IVA sobre la comisión de adquiriente
CUSTOMER_TO_MERCHANT_COMMISSION: Tasa del plan de pago que pone el cliente
CUSTOMER_TO_MERCHANT_COMMISSION_VAT_TAX: IVA sobre la tasa del plan de pago
FINANCIAL_COST: Costo financiero de la tarjeta
FINANCIAL_COST_VAT_TAX: IVA sobre el costo financiero
MERCHANT_VAT_TAX: IVA sobre el total del monto del comercio
MERCHANT_INCOME_TAX: Impuesto a las ganancias del comercio
CUSTOMER_VAT_TAX: IVA sobre el total del monto del cliente
CUSTOMER_INCOME_TAX: Impuesto a las ganancias del cliente
MERCHANT_IIBB_TAX: Ingresos brutos del comercio
INSTALLMENT_AMOUNT: Importe por cuota

  curl --request GET \
    --location 'https://api.menta.global/api/v2/transaction-reports' \
    --header 'Authorization: Bearer {access_token}' \
    --url-query 'page=integer' \
    --url-query 'size=integer' \
    --url-query 'start=string' \
    --url-query 'end=string'

{
  "content": [
    {
      "customer_id": "string",
      "merchant_id": "string",
      "terminal_id": "string",
      "merchant_additional_info": "string",
      "transaction_id": "string",
      "operation_id": "string",
      "operation_number": 0,
      "operation_additional_info": "string",
      "serial_number": "string",
      "operation_type": "PAYMENT",
      "payment_method": "CREDIT",
      "gross_amount": 0,
      "currency": "ARS",
      "datetime": "2024-03-05T20:21:03-03:00",
      "status": "APPROVED",
      "installments": 0,
      "financing": "ESTANDAR",
      "user": "string",
      "acquirer": "string",
      "operation_detail": {
        "card": {
            "card_bin": "string",
            "card_mask": "string",
            "card_brand": "VISA",
            "is_international_card": false
        },
        "holder_name": "string",
        "holder_document": "string",
        "description": "string",
        "input_mode": "CONTACTLESS",
        "cvm_method": "PINONLINE",
        "reference_operation_number": 394221095,
        "reference_operation_id": "50c7571f-750c-43b5-9baf-f5d1d9a4d022",
        "rrn": "string",
        "authorization_code": "string"
      },
      "tax_info": {
        "term": 0,
        "payment_date": "2024-02-23T09:26:54-03:00",
        "net_amount": 0,
        "customer_term": 0,
        "customer_payment_date": "2024-03-04T09:26:54-03:00",
        "customer_net_amount": 0,
        "tax_breakdown": [
          {
            "tax_code": "string",
            "reference": "string",
            "amount": 0,
            "rate": 0
          }
        ]
      }
    }
  ],
  "pageable": {
    "sort": {
      "sorted": true,
      "unsorted": true,
      "empty": true
    },
    "page_number": 0,
    "page_size": 0,
    "offset": 0,
    "paged": true,
    "unpaged": true
  },
  "total_pages": 0,
  "total_elements": 0
}

Eliminar Obtener métricas