Intenciones de Pago

Obtener intención de pago

GET /v1/cloud-terminals/payment-intentions/{requestId}

Permite consultar el detalle de una única intención de pago. Se debe indicar el identificador de la intención a consultar (requestId). La respuesta incluye los datos de la intención (type, status, created_at y data) y, cuando ya existe una transacción asociada, el objeto transaction_details con los datos de la transacción, incluyendo impuestos e información de la tarjeta. Mientras la intención no tenga una transacción asociada, la respuesta es 200 sin el objeto transaction_details. El campo status de primer nivel es el estado de la intención (por ejemplo EXECUTED); el campo status dentro de transaction_details es el estado de la transacción (por ejemplo APPROVED). Los estados de la intención se describen en el endpoint Obtener intenciones de pago.

ParámetrosDescripción
requestId
  • string
  • UUID v4 que identifica la intención (parámetro de ruta)

Parámetros de consulta

ParámetrosDescripción
customerId
  • string
  • Identificador del cliente. Debe corresponder al de las credenciales utilizadas
merchantId
  • string
  • Identificador del comercio. Debe corresponder a un comercio al que tengan acceso las credenciales utilizadas
ℹ️

El requestId puede obtenerse del response del POST al crear la intención (Crear intención de pago) o del endpoint Obtener intenciones de pago, que incluye el request_id en cada ítem de la lista. Ese listado devuelve cada ítem con la misma forma que este endpoint, pero sin el objeto transaction_details.

Si customerId o merchantId no corresponden a las credenciales utilizadas, la respuesta es 403. Si el requestId no existe, la respuesta es 404.

Los campos sin valor se omiten de la respuesta.

Campos de transaction_details

ParámetrosDescripción
merchant_additional_info
  • string
  • Información adicional del comercio
transaction_id
  • string
  • Identificador de la transacción
operation_id
  • string
  • Identificador de la operación
operation_number
  • integer
  • Número de la operación
operation_additional_info
  • string
  • Información adicional de la operación
serial_number
  • string
  • Número de serie de la terminal
operation_type
  • string
  • Tipo de operación (por ejemplo PAYMENT)
payment_method
  • string
  • Medio de pago (por ejemplo DEBIT)
gross_amount
  • number
  • Importe bruto de la transacción
currency
  • string
  • Moneda de la transacción (por ejemplo ARS)
datetime
  • string
  • Fecha y hora de la transacción, con offset
status
  • string
  • Estado de la transacción (por ejemplo APPROVED)
installments
  • integer
  • Cantidad de cuotas
financing
  • string
  • Plan de financiación (por ejemplo ESTANDAR)
user
  • string
  • Usuario que realizó la operación
acquirer
  • string
  • Procesador de la transacción
operation_detail
  • object
  • Detalle de la operación
tax_info
  • object
  • Información de impuestos y liquidación

Campos de operation_detail

ParámetrosDescripción
  • operation_detail.
card
  • object
  • Datos de la tarjeta: card_bin, card_mask, card_brand e is_international_card
  • operation_detail.
holder_name
  • string
  • Nombre del titular de la tarjeta
  • operation_detail.
holder_document
  • string
  • Documento del titular de la tarjeta
  • operation_detail.
description
  • string
  • Descripción del resultado de la operación
  • operation_detail.
input_mode
  • string
  • Modo de lectura de la tarjeta (por ejemplo EMV)
  • operation_detail.
rrn
  • string
  • Número de referencia de la transacción (RRN)
  • operation_detail.
authorization_code
  • string
  • Código de autorización
  • operation_detail.
tip_amount
  • (opcional)
  • number
  • Importe de la propina
  • operation_detail.
reference_operation_number
  • (opcional)
  • integer
  • Número de la operación de referencia
  • operation_detail.
reference_operation_id
  • (opcional)
  • string
  • Identificador de la operación de referencia

Campos de tax_info

ParámetrosDescripción
  • tax_info.
term
  • integer
  • Plazo de acreditación
  • tax_info.
payment_date
  • string
  • Fecha de pago, con offset
  • tax_info.
net_amount
  • number
  • Importe neto
  • tax_info.
tax_breakdown
  • array
  • Desglose de impuestos. Cada ítem tiene tax_code, reference, amount y rate (este último puede omitirse)
  • tax_info.
customer_net_amount
  • (opcional)
  • number
  • Importe neto del cliente
  • tax_info.
customer_term
  • (opcional)
  • integer
  • Plazo de acreditación del cliente
  • tax_info.
customer_payment_date
  • (opcional)
  • string
  • Fecha de pago del cliente, con offset

Encabezados

Authorization: Bearer {access_token}
curl --location --request GET \
  'https://api.menta.global/api/v1/cloud-terminals/payment-intentions/{request_id}?customerId={customer_id}&merchantId={merchant_id}' \
  --header 'Authorization: Bearer {access_token}'

200: OK

{
  "customer_id": "00000000-0000-4000-8000-000000000001",
  "merchant_id": "00000000-0000-4000-8000-000000000002",
  "terminal_id": "00000000-0000-4000-8000-000000000003",
  "request_id": "00000000-0000-4000-8000-000000000004",
  "type": "CLOUD_TERMINAL",
  "status": "EXECUTED",
  "created_at": "2026-10-02T19:27:15Z",
  "data": {
    "flow": "PAYMENT_INTENT",
    "amount": "10000",
    "payment_method": "CREDIT",
    "card_brand": "MASTERCARD",
    "installments": 3,
    "additional_info": "Pago de prueba",
    "is_print_allowed": true,
    "is_tip_allowed": true
  },
  "transaction_details": {
    "merchant_additional_info": "",
    "transaction_id": "00000000-0000-4000-8000-000000000005",
    "operation_id": "00000000-0000-4000-8000-000000000006",
    "operation_number": 836220305,
    "operation_additional_info": "",
    "serial_number": "00000000000001",
    "operation_type": "PAYMENT",
    "payment_method": "DEBIT",
    "gross_amount": 101,
    "currency": "ARS",
    "datetime": "2026-10-02T16:28:12-03:00",
    "status": "APPROVED",
    "installments": 1,
    "financing": "ESTANDAR",
    "user": "[email protected]",
    "acquirer": "GPS",
    "operation_detail": {
      "card": {
        "card_bin": "45079900",
        "card_mask": "XXXXXXXXXXXX9473",
        "card_brand": "VISA",
        "is_international_card": false
      },
      "holder_name": "Tarjetahabiente",
      "holder_document": "",
      "description": "Transacciones exitosas",
      "input_mode": "EMV",
      "rrn": "000000000071",
      "authorization_code": "910732"
    },
    "tax_info": {
      "term": 1,
      "payment_date": "2026-10-05T12:00:00-03:00",
      "net_amount": -99.78,
      "tax_breakdown": [
        {
          "tax_code": "CUSTOMER_TO_MERCHANT_COMMISSION",
          "reference": "Customer to merchant commission",
          "amount": 1.01,
          "rate": 1.00
        },
        {
          "tax_code": "CUSTOMER_TO_MERCHANT_COMMISSION_VAT_TAX",
          "reference": "Customer to merchant commission VAT Tax",
          "amount": 0.21,
          "rate": 21.00
        },
        {
          "tax_code": "MERCHANT_VAT_TAX",
          "reference": "Merchant VAT Tax",
          "amount": 99.78,
          "rate": 21.00
        },
        {
          "tax_code": "MERCHANT_INCOME_TAX",
          "reference": "Merchant Income Tax",
          "amount": 99.78
        }
      ]
    }
  }
}
Listar intenciones de pagoListar terminales cloud