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
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	string Número de 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
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)	string 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. 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. 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]

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
operation_detail.tax_info. term	integer Cantidad de días
operation_detail.tax_info. payment_date	string Fecha de pago [2000-12-31T00:00:00Z]
operation_detail.tax_info. net_amount	number Monto neto
operation_detail.tax_info. customer_term	integer Cantidad de días del cliente
operation_detail.tax_info. customer_payment_date	string Fecha de pago del cliente [2000-12-31T00:00:00Z]
operation_detail.tax_info. customer_net_amount	number Monto neto del cliente
operation_detail.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_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",
        "reference_operation_number": 394221095,
        "reference_operation_id": "50c7571f-750c-43b5-9baf-f5d1d9a4d022"
      },
      "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