Ir al contenido
KUTI

Editar negocio

Edita datos del negocio: razón social, nombre comercial, contacto y dirección. Solo los campos enviados se modifican.

PATCHhttps://api.kuti.pe/v1/merchants/{id}
El RUC, el país y la moneda no se pueden cambiar. Enviar "" borra el valor (excepto legal_name).

Parámetros del body

Campo
Descripción
id
stringrequerido
Id del merchant en el path.Ej: mer_01J8Z3K4M5N6P7Q8R9S0T1U2V3
legal_name
stringopcional
Razón social.
trade_name
stringopcional
Nombre comercial.
email
stringopcional
Correo de contacto.Ej: pagos@cafeandina.pe
phone
stringopcional
Teléfono E.164.Ej: +51987654321
address
objectopcional
Dirección fiscal.
line
stringopcional
Calle y número.
district
stringopcional
Distrito.
province
stringopcional
Provincia.
region
stringopcional
Región / departamento.
ubigeo
stringopcional
Código ubigeo.

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/mer_01J8Z3K4M5N6P7Q8R9S0T1U2V3", {
  method: "PATCH",
  headers: {
    "Authorization": "Bearer kuti_live_…",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "trade_name": "Café Andina Miraflores",
    "phone": "+51987654321",
    "email": "hola@cafeandina.pe"
  })
});

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,
  "message": "Merchant updated",
  "data": {
    "id": "mer_01J8Z3K4M5N6P7Q8R9S0T1U2V3",
    "legal_name": "Cafetería Andina S.A.C.",
    "trade_name": "Café Andina Miraflores",
    "tax_id": {
      "country": "PE",
      "type": "RUC",
      "value": "20123456789"
    },
    "country": "PE",
    "default_currency": "PEN",
    "email": "hola@cafeandina.pe",
    "phone": "+51987654321",
    "status": "ACTIVE",
    "created_at": "2026-09-04T10:48:59.556906Z"
  }
}