Listar Check-ins

Permite listar checkins filtrando por estado, los campos created_from y created_to son obligatorios (rango de 31 días)

GET /v3/checkins

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 consulta

Nombre	Requerido	Descripción
created_from	Sí	Fecha inicial de creación (YYYY-MM-DD). Rango máximo de 31 días.
created_to	Sí	Fecha final de creación (YYYY-MM-DD).
limit	No	Cantidad de resultados por página.
status	No	Filtra por estado del check-in. Ver estados.
page	No	Número de página.

Ejemplo de request

curl -X GET 'https://api.virtualpos-sandbox.com/v3/checkins?created_from=2026-08-11&created_to=2026-08-11' \
  -H 'Content-Type: application/json' \
  -H "Authorization: $API_KEY" \
  -H "Signature: $SIGNATURE"

Respuestas

200 OK

{
  "status": "OK",
  "code": 200,
  "pagination": {
    "limit": 50,
    "page": 1,
    "pages": 1,
    "total": 2
  },
  "checkins": [
    {
      "commerce": {
        "commerce_id": "76478111-2",
        "name": "Virtualpos"
      },
      "client": {
        "uuid_cli": "cli_0316aaaaaaaaaaaa",
        "email": "cliente@ejemplo.cl",
        "first_name": "Cliente",
        "last_name": "Ejemplo",
        "social_id_type": "RUT",
        "social_id": "11111111-1",
        "phone": "564444444",
        "type": "PERSONA"
      },
      "card": {
        "card_reference_id": "card_41b29e22cca2f853cf62aaaaaaaaaaaa",
        "created_at": "2026-04-23 10:21:42",
        "status": "Inscrita",
        "brand": "VISA",
        "last4": "6623",
        "nacional": "T",
        "card_type": "TC",
        "cardholder_name": "Usuario Prueba Card",
        "issuer": "VirtualPOS",
        "issuer_code": "40518856"
      },
      "uuid": "chk_e9674456-f807-43d0-b189-49510baa7dd0",
      "status": "captured",
      "currency": "CLP",
      "description": "reserva",
      "merchant_internal_code": "MIT-AGosto26021998",
      "guarantee_amount": 366113,
      "timing_guarantee": "immediate",
      "prepayment_amount": 0,
      "date_checkin_commerce": "2026-09-21",
      "date_checkout_commerce": "2026-09-30",
      "created_at": "2026-08-07 13:33:07",
      "updated_at": "2026-08-07 13:34:58",
      "limit_checkout_at": "2026-08-08 13:33:07",
      "metadata": {
        "Marca": "Toyota",
        "Modelo": "RAV4 Grey"
      },
      "transactions": [
        {
          "transaction_type": "checkin",
          "status": "authorized",
          "amount": 10111,
          "authorized_at": "2026-08-07 13:33:07",
          "authorization_code": "694052"
        },
        {
          "transaction_type": "incremental",
          "status": "authorized",
          "amount": 356002,
          "authorized_at": "2026-08-07 13:34:43",
          "authorization_code": "320513",
          "description": "Incremental prueba 2"
        },
        {
          "transaction_type": "checkout",
          "status": "captured",
          "amount": 65000,
          "captured_at": "2026-08-07 13:34:58",
          "authorization_code": "674088",
          "payment_uuid": "31481526a7617427"
        }
      ]
    },
    {
      "commerce": {
        "commerce_id": "76478111-2",
        "name": "Virtualpos"
      },
      "client": {
        "uuid_cli": "cli_0316aaaaaaaaaaaa",
        "email": "cliente@ejemplo.cl",
        "first_name": "Cliente",
        "last_name": "Ejemplo",
        "social_id_type": "RUT",
        "social_id": "11111111-1",
        "phone": "564444444",
        "type": "PERSONA"
      },
      "card": {
        "card_reference_id": "card_41b29e22cca2f853cf62aaaaaaaaaaaa",
        "created_at": "2026-04-23 10:21:42",
        "status": "Inscrita",
        "brand": "VISA",
        "last4": "6623",
        "nacional": "T",
        "card_type": "TC",
        "cardholder_name": "Usuario Prueba Card",
        "issuer": "VirtualPOS",
        "issuer_code": "40518856"
      },
      "uuid": "chk_d85e33dd-185e-4de4-97a4-c5786cc0bca5",
      "status": "captured",
      "currency": "CLP",
      "description": "Rent a car",
      "merchant_internal_code": "MIT-AGosto262081",
      "guarantee_amount": 235001,
      "timing_guarantee": "immediate",
      "prepayment_amount": 950002,
      "date_checkin_commerce": "2026-09-21",
      "date_checkout_commerce": "2026-09-30",
      "created_at": "2026-08-07 09:55:21",
      "updated_at": "2026-08-07 10:32:41",
      "limit_checkout_at": "2026-08-08 09:55:21",
      "metadata": {
        "Marca": "Toyota",
        "Modelo": "RAW4 Black"
      },
      "transactions": [
        {
          "transaction_type": "checkin",
          "status": "authorized",
          "amount": 235001,
          "authorized_at": "2026-08-07 09:55:36",
          "authorization_code": "478654"
        },
        {
          "transaction_type": "sale",
          "status": "captured",
          "amount": 950002,
          "captured_at": "2026-08-07 10:24:32",
          "authorization_code": "477716",
          "payment_uuid": "31481456a75eaa05"
        },
        {
          "transaction_type": "checkout",
          "status": "captured",
          "amount": 65000,
          "captured_at": "2026-08-07 10:31:35",
          "authorization_code": "171521",
          "payment_uuid": "31481466a75ec480"
        },
        {
          "transaction_type": "additional_charge",
          "status": "captured",
          "amount": 3333,
          "captured_at": "2026-08-07 10:32:41",
          "authorization_code": "492591",
          "payment_uuid": "31481476a75ec899",
          "charge_reason": "Multa de prueba 2"
        }
      ]
    }
  ]
}

400 Bad Request

{
  "status": "NOK",
  "code": 400,
  "error": {
    "error_code": "E-208",
    "message": "Error en el parámetro status.",
    "doc_url": "https://virtualpos.readme.io/reference/objeto-error"
  }
}