Crear negocio

Solo desde el panel (Negocios → Nuevo negocio). Crea un merchant a partir de un RUC. La razón social, el país (PE), la moneda (PEN) y la dirección fiscal se consultan en SUNAT y no se envían en el body.

POSThttps://api.kuti.pe/v1/merchants

Solo desde el panel (Negocios → Nuevo negocio). Con una API key responde 403 API_KEY_NOT_ALLOWED: cada key pertenece a un negocio ya creado. Solo tax_id.value es obligatorio. No envíes legal_name, country, address ni default_currency: salen de SUNAT. Si el RUC no existe, responde 422. Puedes enviar Idempotency-Key (UUID v4) para reintentos seguros.

Parámetros del body

Campo

Descripción

tax_id

objectrequerido

RUC del negocio. País y tipo se fijan a PE / RUC.

value

stringrequerido

RUC peruano de 11 dígitos (empieza en 10, 15, 17 o 20).Ej: 20123456789

trade_name

stringopcional

Nombre comercial.Ej: Café Andina

email

stringopcional

Correo de contacto.Ej: pagos@cafeandina.pe

phone

stringopcional

Teléfono E.164.Ej: +51999999999

Language

Credentials

Header

Authorization

Secret key de developer · HTTP directo; SDK oficial → /sdks

Fetch Request

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

const response = await fetch("https://api.kuti.pe/v1/merchants", {
  method: "POST",
  headers: {
    "Authorization": "Bearer kuti_live_…",
    "Content-Type": "application/json",
    "Idempotency-Key": "550e8400-e29b-41d4-a716-446655440000"
  },
  body: JSON.stringify({
    "tax_id": {
      "value": "20123456789"
    },
    "trade_name": "Café Andina",
    "email": "pagos@cafeandina.pe",
    "phone": "+51999999999"
  })
});

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

201Created

{
  "success": true,
  "message": "Merchant created",
  "data": {
    "id": "mer_01J8Z3K4M5N6P7Q8R9S0T1U2V3",
    "legal_name": "Cafetería Andina S.A.C.",
    "trade_name": "Café Andina",
    "tax_id": {
      "country": "PE",
      "type": "RUC",
      "value": "20123456789"
    },
    "country": "PE",
    "default_currency": "PEN",
    "email": "pagos@cafeandina.pe",
    "phone": "+51999999999",
    "status": "ACTIVE",
    "address": {
      "line": "AV. AREQUIPA NRO. 123 URB. SANTA BEATRIZ",
      "district": "LIMA",
      "province": "LIMA",
      "region": "LIMA",
      "ubigeo": "150101"
    },
    "created_at": "2026-09-04T10:48:59.556906Z"
  }
}