Recuperar un Check-in

Obtiene el estado actual de un check-in:

• pending → Check-in creado

• abandoned → Check-in abandonado por el cliente

• incomplete → Check-in sin movimientos durante un tiempo definido desde estado

• card_captured → Tokenización exitosa

• card_captured_failed → Tokenización fallida

• authorized → Garantía autorizada

• auth_rejected → Autorización de garantía rechazada

• prepaid → Prepago ejecutado correctamente

• prepayment_rejected → Prepago rechazado

• captured → Checkout ejecutado

• cancelled → Garantía liberada

• expired → Check-in expiró porque no se ejecutó checkout en tiempo definido

Como resultado de la consulta de un Check-in, se pueden obtener distintos tipos de transacciones (transaction_type), dependiendo de las operaciones realizadas durante su ciclo de vida:

• Checkin: Garantía

• Sale: Prepago

• Incremental: Aumento del monto de la garantía

• Checkout: Cobro de la garantía

• Additional charge: Cargo adicional posterior al checkout

• Release: Liberación de la garantía

GET /v3/checkins/{uuid}

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.

Parámetros de ruta

Nombre	Requerido	Descripción
uuid	Sí	UUID del check-in

Ejemplo de request

curl -X GET 'https://api.virtualpos-sandbox.com/v3/checkins/{uuid}' \
  -H 'Content-Type: application/json' \
  -H "Authorization: $API_KEY" \
  -H "Signature: $SIGNATURE"

Respuestas

200 OK

{
  "status": "OK",
  "code": 200,
  "checkin": {
    "commerce": {
      "commerce_id": "76478111-2",
      "name": "Virtualpos"
    },
    "client": {
      "uuid_cli": "cli_0316a6cc349e0876",
      "email": "cliente@ejemplo.cl",
      "first_name": "Cliente",
      "last_name": "Ejemplo",
      "social_id_type": "RUT",
      "social_id": "11111111-1",
      "phone": "56911111111",
      "type": "PERSONA"
    },
    "card": {
      "card_reference_id": "card_d3d35cc0c4e1305b71e1ff7e36116fae",
      "created_at": "2026-07-31 14:18:18",
      "status": "Inscrita",
      "brand": "NN",
      "last4": "0123",
      "nacional": "F",
      "card_type": "NN",
      "cardholder_name": "Prueba KLAP",
      "issuer": "Extranjero",
      "issuer_code": "40055299"
    },
    "uuid": "chk_1772f062-2621-4f40-a3d2-7ea4f2458131",
    "status": "authorized",
    "currency": "CLP",
    "description": "Rent a car",
    "merchant_internal_code": "MIT-AGOst11o2",
    "guarantee_amount": 130000,
    "timing_guarantee": "immediate",
    "prepayment_amount": 950000,
    "date_checkin_commerce": "2026-09-21",
    "date_checkout_commerce": "2026-09-30",
    "created_at": "2026-07-31 14:18:09",
    "updated_at": "2026-07-31 14:24:05",
    "limit_checkout_at": "2026-08-01 14:18:09",
    "metadata": {
      "Marca": "Toyota",
      "Modelo": "RAW4 Blue"
    },
    "transactions": [
      {
        "transaction_type": "checkin",
        "status": "authorized",
        "amount": 130000,
        "authorized_at": "2026-07-31 14:18:20",
        "authorization_code": "988700"
      },
      {
        "transaction_type": "sale",
        "status": "authorized",
        "amount": 950000,
        "authorized_at": "2026-07-31 14:24:04",
        "authorization_code": "569800",
        "payment_uuid": "31479836a6ce8451"
      }
    ]
  }
}