Registrar cuenta bancaria

Solo desde el panel (Ajustes → Cuenta bancaria). Registra una cuenta bancaria de liquidación. El titular lo toma KUTI del negocio (razón social + RUC).

POSThttps://api.kuti.pe/v1/payout-accounts

Solo desde el panel (Ajustes → Cuenta bancaria). Con una API key responde 403 API_KEY_NOT_ALLOWED: así una key filtrada nunca puede desviar tus liquidaciones. Por API solo se consultan (GET /payout-accounts, permiso balance:read). cci debe ser 20 dígitos. account_type: CHECKING o SAVINGS.

Parámetros del body

Campo

Descripción

bank_code

stringrequerido

Código del banco.Ej: BCP

account_type

stringrequerido

CHECKING o SAVINGS.Ej: CHECKING

cci

stringrequerido

CCI de 20 dígitos.Ej: 00212345678901234567

make_default

booleanopcional

Si true, queda como cuenta predeterminada. Default false.

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/payout-accounts", {
  method: "POST",
  headers: {
    "Authorization": "Bearer kuti_live_…",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "bank_code": "BCP",
    "account_type": "CHECKING",
    "cci": "00212345678901234567",
    "make_default": true
  })
});

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": "Payout account created",
  "data": {
    "id": "pacc_01J8Z3K4M5N6P7Q8R9S0T1U2V3",
    "bank_code": "BCP",
    "account_type": "CHECKING",
    "currency": "PEN",
    "cci_masked": "••••4567",
    "holder_name": "ZIZEHOST S.A.C.",
    "holder_doc_type": "RUC",
    "holder_doc_num": "20123456789",
    "is_default": true,
    "status": "ACTIVE",
    "created_at": "2026-09-04T10:48:59.556906Z"
  }
}