Consultar una operación

Devuelve el estado actual de una operación. Úsalo como respaldo del webhook: por ejemplo, si no lo recibiste o tu sistema se reinició mientras esperabas el resultado.

GET /api/v1/pos-operations/{paymentRequestId}

Ambiente	URL base API
Integración	https://ms-payment-c2c.virtualpos-dev.com/ms-payment-c2c
Producción	https://ms-payment-c2c.virtualpos.cl/ms-payment-c2c

Headers

Nombre	Requerido	Descripción
X-Api-Key	Sí	Tu API key.

Parámetros de ruta

Parámetro	Descripción
paymentRequestId	ID de la operación, devuelto al crearla.

Ejemplo de request

curl 'https://ms-payment-c2c.virtualpos-dev.com/ms-payment-c2c/api/v1/pos-operations/8f1c2d3e-4b5a-4c6d-9e7f-0a1b2c3d4e5f' \
  -H "X-Api-Key: $API_KEY"

Respuesta 200 OK

{
  "paymentRequestId": "8f1c2d3e-4b5a-4c6d-9e7f-0a1b2c3d4e5f",
  "externalPaymentId": "orden-10234",
  "posSerial": "VPOS-1A2B3C4D5E",
  "amount": 9900,
  "tipAmount": 0,
  "currency": "CLP",
  "operationType": "SALE",
  "status": "APPROVED",
  "jobId": "job-5d6e7f80-1a2b-4c3d-8e9f-0a1b2c3d4e5f",
  "attemptId": "orden-10234#attempt-1",
  "attemptNumber": 1,
  "callbackUrl": "https://tu-sistema.cl/webhooks/virtualpos",
  "createdAt": "2026-11-13T16:01:10Z",
  "updatedAt": "2026-11-13T16:01:30Z"
}

Campo	Descripción
status	Estado actual. Ver estados.
attemptNumber	Número de intento. Aumenta si repetiste el externalPaymentId de una operación no aprobada.
createdAt / updatedAt	Fecha de creación y de la última actualización, en UTC.

Los campos que no aplican a la operación no se incluyen; por ejemplo, amount no viene en PRINT.

El detalle de la transacción (código de autorización, tarjeta, TID) no viene en esta respuesta: llega en el resultPayload del webhook. Para ver ese contenido, usa Consultar el contenido del webhook.