Leer código de barras

SCAN_BARCODE activa la cámara del POS para leer un código de barras o QR. El valor leído llega a tu sistema por webhook.

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í	SCAN_BARCODE
externalPaymentId	string	Sí	ID de la lectura en tu sistema. Único por lectura.
scanBarcode.timeoutSeconds	integer	No	Segundos que la cámara espera un código, de 1 a 180. Por defecto 60.
scanBarcode.useFrontCamera	boolean	No	true para usar la cámara frontal. Por defecto false.
callbackUrl	string	No	URL donde recibirás los webhooks.

Ejemplo de request

{
  "posSerial": "VPOS-1A2B3C4D5E",
  "operationType": "SCAN_BARCODE",
  "externalPaymentId": "scan-10234",
  "callbackUrl": "https://tu-sistema.cl/webhooks/virtualpos",
  "scanBarcode": {
    "timeoutSeconds": 45,
    "useFrontCamera": false
  }
}

Resultado

Cuando el POS lee el código, la operación pasa a APPROVED y el webhook trae el valor en resultPayload:

{
  "requestId": "scan-10234",
  "resultStatus": "scanned",
  "responseCode": "SCANNED",
  "scanValue": "7801234567890",
  "scanSymbology": "unknown",
  "timestamp": "2026-11-13T12:00:00Z",
  "app2appResponseCode": "M2M_200"
}

Campo	Descripción
scanValue	Valor leído.
scanSymbology	Tipo de código, si el POS lo identifica.