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ámetrosDescripció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]
cardBrand
  • (opcional)
  • string
  • Marca de tarjeta
  • [VISA, MASTERCARD, AMEX]
paymentMethod
  • (opcional)
  • string
  • El método de pago
  • [DEBIT, CREDIT, QR]
status
  • (opcional)
  • string
  • Un listado de estados de las transacciones
  • [APPROVED, REJECTED, REVERSED]

Esquema de la respuesta:

ParámetrosDescripció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.
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ámetrosDescripció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

Esquema del detalle de la tarjeta (card):

ParámetrosDescripció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ámetrosDescripció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ámetrosDescripció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,
      "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"
      },
      "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
}