Crear Checkout

Permite ejecutar el checkout de un check-in, realizando la captura final sobre la garantía previamente autorizada.

Este endpoint debe ser utilizado cuando el comercio finaliza el servicio asociado al check-in y requiere cobrar el monto definitivo correspondiente al checkout.

El monto final del checkout puede ser menor, igual o superior al monto autorizado como garantía, siempre que cumpla con las reglas de tolerancia configuradas para el comercio, MCC, marca y adquirente.

POST /v3/checkins/checkout

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 autorizada vigente
final_checkout_amount	Sí	Monto final del checkout	Puede ser menor que el monto tomado en garantía, igual o superior según regla de MCC-Marca definida por adquirente Debe ser mayor a 0, entero, sin decimales

*El campo final_checkout_amount corresponde al monto definitivo que será capturado al finalizar el check-in. Una vez ejecutado correctamente el checkout, la garantía queda capturada y el check-in pasa a estado captured.

Ejemplo de request

curl -X POST 'https://api.virtualpos-sandbox.com/v3/checkins/checkout' \
  -H 'Content-Type: application/json' \
  -H "Authorization: $API_KEY" \
  -H "Signature: $SIGNATURE" \
  -d '{
  "uuid": "chk_227b799b-d89c-4d86-a562-30d71538b171",
  "final_checkout_amount": 163300
}'

Respuestas

200 OK

{
  "code": 200,
  "status": "OK",
  "checkout": {
    "checkin": {
      "uuid": "chk_beb71934-4b53-46e4-834d-0548b3936414",
      "status": "captured",
      "merchant_internal_code": "RentCard-Agosto",
      "currency": "CLP",
      "guarantee_amount": 235001,
      "final_checkout_amount": 65500
    },
    "transactions": {
      "transaction_type": "checkout",
      "status": "captured",
      "amount": 65500,
      "captured_at": "2026-08-10 15:22:31",
      "authorization_code": "339701",
      "payment_uuid": "31481786a7a24f76"
    }
  }
}