Crear cargos adicionales

Permite generar cargos adicionales asociados a un check-in que ya finalizó su proceso de checkout.

Este endpoint debe ser utilizado cuando el comercio requiere realizar un cobro posterior al checkout, por conceptos adicionales asociados al servicio original.

El cargo adicional sólo puede ser solicitado sobre un check-in con checkout realizado correctamente y dentro del plazo máximo permitido para cargos post checkout.

POST /v3/checkins/additional-charges

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 check-out/captura realizado
amount	Sí	Monto del cargo	Debe ser mayor a 0, entero, sin decimales
charge_reason	Sí	Descripción del cargo que se necesita realizar	Ej.: Multas, daños

Ejemplo de request

curl -X POST 'https://api.virtualpos-sandbox.com/v3/checkins/additional-charges' \
  -H 'Content-Type: application/json' \
  -H "Authorization: $API_KEY" \
  -H "Signature: $SIGNATURE" \
  -d '{
  "uuid": "chk_227b799b-d89c-4d86-a562-30d71538b171",
  "amount": 12500,
  "charge_reason": "Multa TAG autopista 2"
}'

Respuestas

200 OK

{
  "status": "OK",
  "code": 200,
  "checkin": {
    "uuid": "chk_beb71934-4b53-46e4-834d-0548b3936414",
    "status": "captured",
    "merchant_internal_code": "RentCard-Agosto",
    "currency": "CLP",
    "description": "rent car",
    "guarantee_amount": 235001,
    "timing_guarantee": "immediate",
    "prepayment_amount": 135990,
    "updated_at": "2026-08-10 15:25:31"
  },
  "transactions": {
    "transaction_type": "additional_charge",
    "status": "captured",
    "amount": 155000,
    "currency": "CLP",
    "charge_reason": "Multa de prueba",
    "captured_at": "2026-08-10 15:25:31",
    "authorization_code": "960383",
    "payment_uuid": "31481796a7a25abc"
  }
}