Detalle de cliente

Obtiene un customer por id (cus_…). Incluye payment_intents_count.

GEThttps://api.kuti.pe/v1/customers/{id}

Solo puedes leer clientes de tu merchant (el de la API key).

Path

Campo

Descripción

id

stringrequerido

Id del customer en el path.Ej: cus_01J8Z3K4M5N6P7Q8R9S0T1U2V3

Language

Credentials

Header

Authorization

Secret key de developer · ejemplos con SDK oficial

API Request

$ npm install @kuti-pe/node

import { KutiClient } from "@kuti-pe/node";

const kuti = new KutiClient({ secretKey: process.env.KUTI_SECRET_KEY! });

const result = await kuti.customers.retrieve("cus_01J8Z3K4M5N6P7Q8R9S0T1U2V3");
console.log(result);

SDK oficial · guía en /sdks

Response

Elige un ejemplo de respuesta:

application/json

200OK

{
  "success": true,
  "data": {
    "id": "cus_01J8Z3K4M5N6P7Q8R9S0T1U2V3",
    "merchant_id": "mer_01J8Z3K4M5N6P7Q8R9S0T1U2V3",
    "external_id": "cust_erp_4821",
    "type": "INDIVIDUAL",
    "first_name": "María",
    "last_name": "López",
    "document": {
      "type": "DNI",
      "number": "45678912",
      "country": "PE"
    },
    "email": "maria@example.com",
    "phone": "+51987654321",
    "payment_intents_count": 3,
    "created_at": "2026-09-04T10:48:59.556906Z"
  }
}