Crear un Incremental

Permite solicitar un incremento del monto de garantía asociado a un check-in previamente autorizado.

Este endpoint debe ser utilizado cuando el comercio requiere aumentar el monto reservado originalmente como garantía.

El incremental sólo puede ser solicitado sobre un check-in con garantía vigente y dentro del plazo máximo permitido para la captura de la garantía, según las reglas aplicadas al comercio/adquirente.

POST /v3/checkins/incremental

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 y con garantía vigente
amount	Sí	Monto del cargo	Debe ser mayor a 0, entero, sin decimales
description	Sí	Descripción o motivo del incremental	Ej.: Extensión arriendo

Ejemplo de request

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

Respuestas

200 OK

{
  "code": 200,
  "status": "OK",
  "checkin": {
    "uuid": "chk_8d79fd0c-5332-4dcb-bd6c-be4a76caa419",
    "status": "authorized",
    "merchant_internal_code": "JR_nuevos-061",
    "currency": "CLP",
    "guarantee_amount": 873028,
    "transactions": {
      "transaction_type": "incremental",
      "status": "authorized",
      "amount": 563000,
      "currency": "CLP",
      "authorized_at": "2026-07-03 14:42:22",
      "authorization_code": "970642"
    }
  }
}