Obtener serial del POS

GET_SERIAL pide al POS su número de serie. Sirve para comprobar que el equipo está encendido, conectado y responde a tu sistema.

POST /api/v1/pos-operations

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
Content-Type	Sí	application/json
X-Api-Key	Sí	Tu API key.

Body

Campo	Tipo	Requerido	Descripción
posSerial	string	Sí	Serial del POS.
operationType	string	Sí	GET_SERIAL
externalPaymentId	string	Sí	ID de la consulta en tu sistema. Único por consulta.
callbackUrl	string	No	URL donde recibirás los webhooks.

Ejemplo de request

{
  "posSerial": "VPOS-1A2B3C4D5E",
  "operationType": "GET_SERIAL",
  "externalPaymentId": "serial-10234",
  "callbackUrl": "https://tu-sistema.cl/webhooks/virtualpos"
}

Resultado

La operación pasa a APPROVED y el webhook trae en resultPayload:

{
  "requestId": "serial-10234",
  "resultStatus": "ok",
  "responseCode": "SERIAL_OBTAINED",
  "message": "Numero de serie obtenido",
  "posSerial": "VPOS-1A2B3C4D5E",
  "timestamp": "2026-11-13T12:00:00Z",
  "app2appResponseCode": "M2M_200"
}