Intenciones de Pago

Obtener intenciones de pago

`GET /v1/cloud-terminals/payment-intentions`

Obtiene las intenciones de pago (eventos de tipo CLOUD_TERMINAL) con filtros por terminal, requestId, rango de fechas, flow y paginación. Devuelve los eventos de tipo CLOUD_TERMINAL, que incluyen intenciones de pago y cancelaciones. Para acotar el resultado se puede enviar flow.

Parámetros de consulta

Parámetros	Descripción
merchantId (opcional)	string Filtro por comercio
terminalId (opcional)	string Identificador del terminal
requestId (opcional)	string Identificador de la intención de pago
start (opcional)	string Inicio del rango. Formato: yyyy-MM-dd'T'HH:mm:ssXXX, incluyendo el offset (por ejemplo 2026-09-30T00:00:00-03:00 o 2026-09-30T00:00:00Z)
end (opcional)	string Fin del rango. Mismo formato que start, incluyendo el offset
flow (opcional)	string Filtro por flow
status (opcional)	string Filtro por estado de la intención, igual al valor de la tabla de estados
page (opcional)	integer Número de página (0-based). Por defecto: 0
size (opcional)	integer Tamaño de página. Por defecto: 10

⚠️

start y end requieren un offset (Z o por ejemplo -03:00). En la URL, el signo + de un offset debe codificarse como %2B.

Estados de intenciones de pago

Valor	Descripción
`CREATED`	Creado.
`PENDING`	Pendiente de entrega a la terminal.
`DELIVERED`	Entregado a la terminal.
`PROCESSING`	La terminal recibió la solicitud de intención de pago.
`EXECUTED`	Cobro confirmado por la operación (estado final).
`CANCELLED`	Intención anulada, o cancelada automáticamente si tras 3 minutos no se recibió la confirmación del cobro (estado final).
`NOT_DELIVERED`	No entregado a la terminal (estado final de error).

Filtros válidos para el parámetro `flow`

Valor	Descripción
`PAYMENT_INTENT`	Intención de pago.
`PAYMENT_CANCELLATION`	Cancelación de pago.

Encabezados

Authorization: Bearer {access_token}

curl --location --request GET \
  'https://api.menta.global/api/v1/cloud-terminals/payment-intentions?terminalId={terminal_id}&page=0&size=10' \
  --header 'Authorization: Bearer {access_token}'

200: OK

{
  "data": [
    {
      "customer_id": "1176a88f-b436-4068-8189-5bfb19bfc3a2",
      "merchant_id": "5f520602-38f8-4067-a8b1-fe363f8b481d",
      "terminal_id": "42cc723b-017d-4ecf-ab10-05f20bafa4da",
      "request_id": "a7f0f6e7-a6fb-4cec-ac08-f43ded94308a",
      "type": "CLOUD_TERMINAL",
      "status": "CREATED",
      "created_at": "2026-02-10T14:59:07Z",
      "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
      }
    }
  ],
  "page": {
    "size": 10,
    "total_elements": 10,
    "total_pages": 1,
    "number": 0
  }
}

401: Unauthorized

{ "datetime": "2025-06-11T13:26:01.176Z", "errors": [{ "message": "Unauthorized" }] }

500: Internal Server Error

{ "status_code": 500, "message": "internal server error" }

Cancelar intención de pago Obtener intención de pago