Detalle de sesión de checkout

Consulta el estado de una sesión. Público: autentica con client_secret (query o X-Kuti-Token).

GEThttps://api.kuti.pe/v1/checkout-sessions/{id}

Público: no uses Authorization Bearer. Autoriza con el client_secret de la sesión — query ?client_secret=… o header X-Kuti-Token (mismo valor; el header tiene prioridad).

Query

Campo

Descripción

client_secret

stringopcional

Secret de la sesión (si no usas X-Kuti-Token).

Path

Campo

Descripción

id

stringrequerido

Id de la sesión (cs_…).Ej: cs_01J8Z3K4M5N6P7Q8R9S0T1U2V3

Language

Credentials

Header

X-Kuti-Token

client_secret de la sesión (no uses tu secret key). Alternativa: ?client_secret=…

Fetch Request

$ # Node 18+ fetch · SDK oficial: npm i @kuti-pe/node

const response = await fetch("https://api.kuti.pe/v1/checkout-sessions/cs_01J8Z3K4M5N6P7Q8R9S0T1U2V3", {
  method: "GET",
  headers: {
    "X-Kuti-Token": "cs_secret_…"
  }
});

const data = await response.json();
console.log(data);

HTTP directo · este endpoint aún no está en el SDK v1 → /sdks

Response

Elige un ejemplo de respuesta:

application/json

200OK

{
  "success": true,
  "data": {
    "id": "cs_01J8Z3K4M5N6P7Q8R9S0T1U2V3",
    "merchant_id": "mer_01J8Z3K4M5N6P7Q8R9S0T1U2V3",
    "payment_intent_id": "pi_01J8Z3K4M5N6P7Q8R9S0T1U2V3",
    "amount": {
      "amount": "249.90",
      "currency": "PEN"
    },
    "status": "COMPLETED",
    "checkout_url": "https://pay.kuti.pe/embed?cs=cs_secret_ab12cd34ef56",
    "created_at": "2026-09-04T10:48:59.556906Z"
  }
}