Autorizar garantía diferida

Permite ejecutar la autorización de una garantía diferida asociada a un check-in previamente creado.

Este endpoint debe ser utilizado cuando el comercio configuró la garantía con modalidad diferida y requiere realizar la preautorización en un momento posterior a la captura/tokenización de la tarjeta.

La autorización sólo puede ser solicitada sobre un check-in válido, con tarjeta registrada correctamente y dentro del plazo permitido para ejecutar garantías diferidas.

POST /v3/checkins/authorize

Ambiente	URL base API	Portal de comercio
Sandbox	https://api.virtualpos-sandbox.com	comercios.virtualpos-sandbox.com
Producción	https://api.virtualpos.cl	comercios.virtualpos.cl

Headers

Nombre	Requerido	Descripción
Content-Type	Sí	application/json
Authorization	Sí	API KEY del comercio
Signature	Sí	JWT HS256 firmado con la SECRET KEY, payload {"ciat": <timestamp>}. Ver firma de Checkins.

Body

Campo	Obligatorio	Regla	Observación
uuid	Sí	ID del checkin	Debe corresponder a un check-in existente, con tarjeta registrada y garantía pendiente de autorización
amount	Sí	Monto a autorizar como garantía	Puede ser menor,igual o mayor que el monto ingresado al ejecutar el check-in. Debe ser mayor a 0, entero, sin decimales

Ejemplo de request

curl -X POST 'https://api.virtualpos-sandbox.com/v3/checkins/authorize' \
  -H 'Content-Type: application/json' \
  -H "Authorization: $API_KEY" \
  -H "Signature: $SIGNATURE" \
  -d '{
  "uuid": "chk_14611bdd-4351-4400-bbc4-b7b6c42fd203",
  "amount": 23456
}'

Respuestas

200 OK

{
  "code": 200,
  "status": "OK",
  "checkin": {
    "uuid": "chk_4f9a3cf9-158b-408e-b4bd-470c9470414f",
    "status": "authorized",
    "merchant_internal_code": "Reserva RCAR201",
    "currency": "CLP",
    "guarantee_amount": 20000,
    "timing_guarantee": "deferred",
    "updated_at": "2026-06-03 15:03:15",
    "transactions": {
      "transaction_type": "checkin",
      "status": "authorized",
      "amount": 23456,
      "currency": "CLP",
      "authorized_at": "2026-06-03 15:03:15",
      "authorization_code": "431852"
    }
  }
}