Ir al contenido

Crear cliente

Crea un customer (pagador) para el merchant autenticado por tu API key.

POSThttps://api.kuti.pe/v1/customers
type es obligatorio: INDIVIDUAL (persona) o COMPANY (empresa). Persona usa first_name/last_name; empresa usa company_name. Puedes enviar Idempotency-Key (UUID v4).

Parámetros del body

type
stringrequerido
INDIVIDUAL o COMPANY.Ej: INDIVIDUAL
external_id
stringopcional
Id en tu sistema (ERP, CRM, …).Ej: cust_erp_4821
first_name
stringopcional
Nombres (INDIVIDUAL).Ej: María
last_name
stringopcional
Apellidos (INDIVIDUAL).Ej: López
company_name
stringopcional
Razón social (COMPANY).
document
objectopcional
Documento de identidad.
country
stringopcional
ISO 3166-1 alpha-2.Ej: PE
type
stringopcional
DNI, RUC, CE, PASSPORT, …Ej: DNI
value
stringopcional
Número del documento.Ej: 45678912
email
stringopcional
Correo.Ej: maria@example.com
phone
stringopcional
Teléfono E.164.Ej: +51987654321
merchant_id
stringopcional
Opcional. Si se envía debe coincidir con el merchant de la key.Ej: mer_01J8Z3K4M5N6P7Q8R9S0T1U2V3
metadata
objectopcional
Pares string→string libres.

Language

Credentials

Header

Authorization

Secret key de developer · ejemplos con librerías estándar (aún sin SDK)

cURL Request
curl -s 'https://api.kuti.pe/v1/customers' \
  -X POST \
  -H 'Authorization: Bearer kuti_live_…' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: 550e8400-e29b-41d4-a716-446655440001' \
  -d '{
  "type": "INDIVIDUAL",
  "external_id": "cust_erp_4821",
  "first_name": "María",
  "last_name": "López",
  "document": {
    "country": "PE",
    "type": "DNI",
    "value": "45678912"
  },
  "email": "maria@example.com",
  "phone": "+51987654321"
}'
Librería estándar · sin SDK propio
Response

Elige un ejemplo de respuesta:

application/json
201Created
{
  "success": true,
  "message": "Customer created",
  "data": {
    "id": "cus_01J8Z3K4M5N6P7Q8R9S0T1U2V3",
    "merchant_id": "mer_01J8Z3K4M5N6P7Q8R9S0T1U2V3",
    "external_id": "cust_erp_4821",
    "type": "INDIVIDUAL",
    "first_name": "María",
    "last_name": "López",
    "document": {
      "country": "PE",
      "type": "DNI",
      "value": "45678912"
    },
    "email": "maria@example.com",
    "phone": "+51987654321",
    "created_at": "2026-09-04T10:48:59.556906Z"
  }
}