Crear un Prepago

Permite ejecutar un prepago asociado a un check-in existente utilizando la tarjeta previamente registrada en el proceso de check-in.

Este endpoint debe ser utilizado cuando el comercio requiere realizar un cobro anticipado durante la vigencia del check-in, posterior a la autorización de la garantía y antes de ejecutar el checkout. Por ejemplo, para cobrar un servicio de arriendo.

El prepago puede aplicarse a check-ins configurados originalmente con garantía inmediata o diferida, siempre que exista una garantía autorizada y vigente.

Solo se permite una ejecución exitosa de prepago por check-in.

POST /v3/checkins/prepayment

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 check-in	Debe corresponder a un check-in existente con garantía autorizada y vigente
amount	Sí	Monto del prepago	Debe ser mayor a 0, entero y sin decimales
payment_description	Sí	Descripción o concepto del prepago	Ej.: Arriendo

Ejemplo de request

curl -X POST 'https://api.virtualpos-sandbox.com/v3/checkins/prepayment' \
  -H 'Content-Type: application/json' \
  -H "Authorization: $API_KEY" \
  -H "Signature: $SIGNATURE" \
  -d '{
  "uuid": "chk_edfcce39-a3eb-4bc8-beaa-5220da134d26",
  "amount": 120000,
  "payment_description": "Arriendo"
}'

Respuestas

200 OK

{
  "status": "OK",
  "code": 200,
  "checkin": {
    "uuid": "chk_beb71934-4b53-46e4-834d-0548b3936414",
    "status": "authorized",
    "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:14:39"
  },
  "transactions": {
    "transaction_type": "sale",
    "status": "captured",
    "amount": 135990,
    "currency": "CLP",
    "payment_description": "Servicio Arriendo",
    "captured_at": "2026-08-10 15:14:39",
    "authorization_code": "054075",
    "payment_uuid": "31481756a7a231f3"
  }
}