Intenciones de Pago

Obtener intenciones de pago

`GET /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. Este endpoint filtra únicamente por intenciones de pago.

Parámetros de consulta

Parámetros	Descripción
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:ss
end (opcional)	string Fin del rango. Formato: yyyy-MM-dd'T'HH:mm:ss
flow (opcional)	string Filtro por flow
page (opcional)	integer Número de página (0-based). Por defecto: 0
size (opcional)	integer Tamaño de página. Por defecto: 10

Estados de intenciones de pago

Valor	Descripción
`CREATED`	Creado.
`PENDING`	Pendiente.
`DELIVERED`	Entregado.
`EXECUTED`	Ejecutado (estado final).
`NOT_DELIVERED`	No entregado (estado final de error).

Filtro válidos para el parametro `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
  }
}

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