Preautorización (check-in)

Una preautorización (CHECKIN) reserva un monto en la tarjeta de tu cliente sin cobrarlo todavía. Es útil para hoteles, arriendos o servicios en que el monto final se conoce al terminar. Para cobrar, cierras la preautorización con un checkout.

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í	`CHECKIN`
`externalPaymentId`	string	Sí	ID de la reserva en tu sistema. Único por operación.
`amount`	integer	Sí	Monto a preautorizar, en pesos sin decimales. Mayor que 0.
`currency`	string	No	Solo `CLP`. Por defecto `CLP`.
`callbackUrl`	string	No	URL donde recibirás los webhooks.

No acepta tipAmount: la propina solo aplica a ventas.

Ejemplo de request

curl -X POST 'https://ms-payment-c2c.virtualpos-dev.com/ms-payment-c2c/api/v1/pos-operations' \
  -H 'Content-Type: application/json' \
  -H "X-Api-Key: $API_KEY" \
  -d '{
  "posSerial": "VPOS-1A2B3C4D5E",
  "operationType": "CHECKIN",
  "externalPaymentId": "reserva-5521",
  "amount": 100000,
  "currency": "CLP",
  "callbackUrl": "https://tu-sistema.cl/webhooks/virtualpos"
}'

Respuesta

201 Created con la operación en estado DISPATCHED, con la misma forma que en Crear una venta.

Resultado

Cuando el cliente presenta su tarjeta, recibes un webhook con status: "APPROVED". Su resultPayload tiene los mismos campos que el de una venta.