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	date La fecha de inicio del rango de búsqueda [yyyy-MM-ddTHH:mm:ssZ]
end	date La fecha de inicio del rango de búsqueda [yyyy-MM-ddTHH:mm:ssZ]
operationId (opcional)	string Número de operación
merchantId (opcional)	integer Identificador del comercio que realizó las transacciones, obligatorio si el usuario es del tipo comercio
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, REJECTED, REVERSED]

Esquema de la respuesta:

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

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

Parámetros	Descripción
reference_operation_id (opcional)	string ID de operación de pago de referencia (solo aplica para REFUND y ANNULMENT)
reference_operation_number (opcional)	string Número de operación de pago de referencia (solo aplica para REFUND y ANNULMENT)
qr_id (opcional)	string ID del código QR asociado a la transacción
additional_info (opcional)	string Información adicional sobre la operación
card (opcional)	object Detalles de la tarjeta utilizada en la operación
holder_name (opcional)	string Nombre del titular de la tarjeta
holder_document (opcional)	string Documento de identificación del titular de la tarjeta
description (opcional)	string Descripción de la operación
tip_amount (opcional)	number Monto de las propinas
wallet_name (opcional)	string Nombre de la billetera
input_mode (opcional)	string Método de lectura [CONTACTLESS, EMV, STRIPE]

Esquema del detalle de la tarjeta (card):

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

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

Parámetros	Descripción
term	integer Cantidad de días
payment_date	string Fecha de pago [2000-12-31T00:00:00Z]
net_amount	number Monto neto
customer_term	integer Cantidad de días del cliente
customer_payment_date	string Fecha de pago del cliente [2000-12-31T00:00:00Z]
customer_net_amount	number Monto neto del cliente
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_COMMISSION_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

  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",
      "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"
      },
      "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
}

Obtener transacciones Obtener usuarios