Errores

POS Cloud to Cloud usa su propio formato de error, distinto al objeto Error del resto de la API:

{
  "code": "400",
  "message": "currency must be CLP"
}

Campo	Descripción
code	Código HTTP, como texto.
message	Detalle del error.

Códigos HTTP

Código	Cuándo ocurre
200 OK	Repetiste un externalPaymentId: la respuesta trae la operación existente. Ver idempotencia. No es un error.
201 Created	La operación se creó. Si viene con status: "FAILED", no se pudo enviar al POS.
400 Bad Request	La solicitud no es válida. Ver causas abajo.
401 Unauthorized	Falta el header X-Api-Key o la API key no es válida. Esta respuesta no trae body.
403 Forbidden	El POS no está habilitado para POS Cloud to Cloud en tu comercio, o la operación pertenece a otro comercio.
404 Not Found	No existe una operación con ese paymentRequestId.
500 Internal Server Error	Error inesperado de Virtualpos. Reintenta con el mismo externalPaymentId para no duplicar la operación.

Causas frecuentes de 400

• Faltan campos obligatorios: posSerial, operationType o externalPaymentId.
• amount ausente o menor o igual a 0 en SALE, CHECKIN o CHECKOUT.
• currency distinto de CLP.
• tipAmount en una operación distinta de SALE.
• CHECKOUT sin checkout.preauthPosTransactionId.
• PRINT sin print.lines ni print.voucher, o con ambos.
• print.copies fuera del rango 1 a 3, o más de 400 líneas.
• print.voucher sin un copy válido, sin identificador, con ambos identificadores o con un operational_tid inválido.
• scanBarcode.timeoutSeconds fuera del rango 1 a 180.
• La solicitud supera los 300 KB.
• limit o status inválidos al listar operaciones.

201 con status: "FAILED"

La operación quedó registrada, pero no se pudo enviar al POS. Revisa que:

1. El posSerial sea correcto.
2. El POS esté encendido, con conexión a internet y con la app Virtualpos abierta.
3. El POS esté habilitado para POS Cloud to Cloud.

Si el problema continúa, escríbenos a soporte@virtualpos.cl con el paymentRequestId.