Ваши клиенты и их кредиты

Клиент здесь — это клиент вашего собственного продукта, названный идентификатором, который ему даёт ваша система. Slen ведёт счета кредитов ваших клиентов, берёт с них кредиты, когда флоу выполняется для них, и отклоняет запуск, за который они не могут заплатить. Операции этой страницы добавляют и удаляют клиентов, настраивают их счета, двигают их кредиты, блокируют клиента и задают, сколько кредитов стоит операция. Консоль показывает тех же клиентов на экране Клиенты.

Клиенты и счета

• Клиента называет external_user_id — тот же идентификатор, который запрос, запускающий флоу, отправляет в context.user_id. Это непрозрачный идентификатор вашей системы, а не адрес почты и не имя.

• PUT /v1/customers/{externalUserId} добавляет клиента без кредитов и без счёта. Он отвечает 201, когда создал клиента, и 200, когда клиент уже был, поэтому повтору не нужен ключ.

• Счёт принадлежит одному клиенту и одному типу кредитов. Тип кредитов — имя, которое вы выбираете сами; если его не указать, это default. У клиента с двумя типами кредитов два счёта.

• Счёт создаёт первое пополнение его типа кредитов или его настройки. Списание и корректировка ничего не создают.

• Счёт несёт balance, reserved и available. reserved — это то, что держат идущие вызовы, а available — это balance минус reserved.

• Для клиента, которого проект никогда не видел, ответ — 404 с кодом customer_not_found. Для клиента без счетов accounts в ответе пустой.

Чтение требует customers:read, а каждое изменение — customers:write, кроме задания цены, которое требует management:write. Ключ вашего приложения с gateway:write и customers:write запускает флоу и ведёт своих клиентов и больше ничего не меняет.

Настройки счёта

PUT /v1/customers/{externalUserId}/accounts/{creditType} задаёт обе настройки счёта сразу. Он создаёт клиента и счёт, когда их нет, и отвечает 201, а иначе меняет настройки и отвечает 200.

• allow_negative разрешает счёту уходить ниже нуля. По умолчанию разрешение выключено, и тогда холд или списание, которые счёт не может покрыть, отклоняются с insufficient_credits. Его можно выключить, пока баланс ниже нуля: защита действует со следующего движения.

• low_balance_threshold задаёт уровень события вебхука customer.balance_low. Событие отправляется, когда движение переводит available с этого уровня или выше на значение ниже него. Ноль, значение по умолчанию, отключает событие.

• Пополнение и корректировка не меняют настройки: тело, в котором названо любое из этих полей, отклоняется с 422.

Как запуск тратит кредиты

Запуск тратит кредиты, когда он называет клиента в context.user_id и у проекта есть цена в кредитах для его операции. context.credit_type называет тип кредитов, а без него тип — default. Тип кредитов решает, какой счёт платит и какая цена применяется.

• Операция без цены для этого типа кредитов или с нулевой ценой не берёт кредитов.

• Каждый вызов модели в запуске резервирует цену на счёте до того, как модель вызвана. Когда вызов завершён и рассчитан, холд становится расходом, а вызов, который не удался, возвращает его.

• Счёт, который не может покрыть цену, отклоняет вызов с кодом insufficient_credits. Запуск для клиента, у которого нет счёта этого типа кредитов, отклоняется так же.

• Запуск для клиента, которого проект не знает, отклоняется с кодом customer_not_found.

• Запуск для заблокированного клиента отклоняется с кодом customer_blocked — Заблокировать клиента.

Цена задаётся для кода операции и типа кредитов, и следующий холд уже использует её. Повторное задание цены заменяет её, а уже взятый холд сохраняет цену, по которой он взят.

Движения кредитов

Кредиты двигают три операции. Каждая требует заголовок Idempotency-Key длиной не больше 190 символов, а запрос без него отвечает 400 с кодом idempotency_key_required.

• Пополнение добавляет кредиты. Оно создаёт клиента и счёт, когда их нет.

• Списание (charge) снимает кредиты за то, что ваше приложение продаёт само, — выгрузку, место. Выписка показывает его как charge. Для клиента, которого проект не знает, ответ — 404 с кодом customer_not_found, а для клиента без счёта этого типа кредитов — 402 с кодом insufficient_credits.

• Корректировка исправляет баланс. Её credits имеет знак, а ноль отклоняется. Если счёта нет, ответ — 404 с кодом customer_not_found.

Что у трёх общего:

• У credits не больше четырёх знаков после точки. Пятый знак отклоняется с 422, а не округляется.

• note, до 255 символов, сохраняется в записи и виден в выписке: номер счёта на оплату, причина.

• Списание или корректировка не могут опустить баланс ниже того, что держит счёт, если счёт не допускает отрицательный баланс. Такой запрос отвечает 402 с кодом insufficient_credits. Пополнение так не отклоняется никогда, в том числе на счёте ниже нуля.

• Заблокированного клиента можно пополнять, с него можно списывать, и его можно корректировать.

• Списание — не расход: отчёт маржи сопоставляет кредиты вызова с тем, сколько вызов стоил, а за списанием не стоит никакой вызов.

Повтор с ключом ничего не двигает.

• Повтор того же запроса с его ключом отвечает 200. В течение 24 часов, если сервис не настроен иначе, ответом служит первый ответ, с балансом того момента. Потом — счёт в его нынешнем виде.

• Если ключ уже называет другое пополнение, списание или корректировку проекта, ответ — 409 с кодом idempotency_conflict. В эти 24 часа любое другое тело под этим ключом — другой запрос, в том числе другой note. Потом другой клиент, другой тип кредитов, другой вид движения или другая сумма — это другое движение. Новому движению нужен новый ключ.

• Отклонённое движение не сохраняется: тот же запрос можно отправить снова с его ключом.

Заблокировать клиента

POST /v1/customers/{externalUserId}/block блокирует клиента, а POST /v1/customers/{externalUserId}/unblock снова его пускает.

• Новый запуск заблокированного клиента отклоняется с 403 и кодом customer_blocked до того, как что-либо создано.

• Его запуск, который уже идёт, — в очереди или в ожидании согласования, — отклоняется на следующем холде кредитов вызова модели. Узел модели выходит через Отказ, а без ветки там выполнение заканчивается со статусом rejected и кодом customer_blocked. Запуск операции без цены в кредитах не резервирует кредиты и доходит до конца.

• Повтор запроса с ключом, с которым он был отправлен до блокировки, получает в ответ то выполнение.

• Кредиты по-прежнему двигаются, настройки меняются, а выписка читается, поэтому с заблокированным клиентом можно рассчитаться.

• blocked_at — момент первой блокировки. Повторная блокировка его сохраняет и заменяет block_reason, только когда передан reason. Разблокировка очищает оба поля.

Удалить клиента

DELETE /v1/customers/{externalUserId} удаляет клиента и его счета, только когда с ним ничего не происходило: каждый счёт на нуле и ничего не зарезервировано, а в выписке нет ни одной записи. Иначе клиент остаётся, а ответ объясняет почему.

{
  "error": {
    "code": "customer_has_history",
    "message": "The customer has credits or a credit history and cannot be deleted; block it instead",
    "request_id": "5d8a3f1c-2b6e-4c9a-8f17-3e0b9d4c6a25"
  }
}

Выписка объясняет баланс, поэтому она хранится. Такого клиента заблокируйте. Удаление и движение одного и того же клиента никогда не обходят друг друга: удаление, которое встретило идущее пополнение, ждёт и затем отказывает, а пополнение, которое встретило идущее удаление, ждёт и затем создаёт клиента заново.

Читать клиентов и выписки

• Список делится на страницы, самый новый клиент — первым, и каждый клиент приходит со всеми своими счетами. status оставляет активных или заблокированных клиентов, q — клиентов, чей external_user_id его содержит, а credit_type — тех, у кого есть счёт этого типа кредитов.

• low_balance — это число, а не флаг: он оставляет клиентов, у которых есть счёт с available ниже него, — счёт типа credit_type, когда переданы оба. Фильтры выбирают клиентов и никогда не укорачивают список их счетов.

• Выписка клиента перечисляет каждое движение его кредитов, самое новое — первым. Запись несёт счёт таким, каким его оставило движение, в balance_after и available_after, и note запроса. entry_type оставляет один вид движений, а credit_type — движения одного счёта. У клиента без счетов выписка пустая.

Не складывайте credits, чтобы узнать, сколько потратил клиент. У вызова, который потратил кредиты, две отрицательные записи на одну и ту же цену — его hold и его commit, и расход — это только записи commit.

Операции

{
  "data": [
    {
      "customer_id": "74438200973594624",
      "external_user_id": "user_8421",
      "status": "active",
      "blocked_at": "2026-10-02T09:30:00Z",
      "block_reason": "string",
      "accounts": [
        {
          "customer_account_id": "74438200973594624",
          "customer_id": "74438200973594624",
          "project_id": "74438200973594624",
          "external_user_id": "user_8421",
          "credit_type": "default",
          "balance": "12.5000",
          "reserved": "12.5000",
          "available": "12.5000",
          "allow_negative": true,
          "low_balance_threshold": "12.5000",
          "created_at": "2026-10-02T09:30:00Z",
          "updated_at": "2026-10-02T09:30:00Z"
        }
      ],
      "created_at": "2026-10-02T09:30:00Z",
      "updated_at": "2026-10-02T09:30:00Z"
    }
  ],
  "meta": {
    "limit": 1,
    "next_cursor": "string"
  }
}

{
  "data": {
    "customer_id": "74438200973594624",
    "external_user_id": "user_8421",
    "status": "active",
    "blocked_at": "2026-10-02T09:30:00Z",
    "block_reason": "string",
    "accounts": [
      {
        "customer_account_id": "74438200973594624",
        "customer_id": "74438200973594624",
        "project_id": "74438200973594624",
        "external_user_id": "user_8421",
        "credit_type": "default",
        "balance": "12.5000",
        "reserved": "12.5000",
        "available": "12.5000",
        "allow_negative": true,
        "low_balance_threshold": "12.5000",
        "created_at": "2026-10-02T09:30:00Z",
        "updated_at": "2026-10-02T09:30:00Z"
      }
    ],
    "created_at": "2026-10-02T09:30:00Z",
    "updated_at": "2026-10-02T09:30:00Z"
  }
}

{}

{
  "data": {
    "customer_id": "74438200973594624",
    "external_user_id": "user_8421",
    "status": "active",
    "blocked_at": "2026-10-02T09:30:00Z",
    "block_reason": "string",
    "accounts": [
      {
        "customer_account_id": "74438200973594624",
        "customer_id": "74438200973594624",
        "project_id": "74438200973594624",
        "external_user_id": "user_8421",
        "credit_type": "default",
        "balance": "12.5000",
        "reserved": "12.5000",
        "available": "12.5000",
        "allow_negative": true,
        "low_balance_threshold": "12.5000",
        "created_at": "2026-10-02T09:30:00Z",
        "updated_at": "2026-10-02T09:30:00Z"
      }
    ],
    "created_at": "2026-10-02T09:30:00Z",
    "updated_at": "2026-10-02T09:30:00Z"
  }
}

{
  "data": {
    "customer_id": "74438200973594624",
    "external_user_id": "user_8421",
    "status": "active",
    "blocked_at": "2026-10-02T09:30:00Z",
    "block_reason": "string",
    "accounts": [
      {
        "customer_account_id": "74438200973594624",
        "customer_id": "74438200973594624",
        "project_id": "74438200973594624",
        "external_user_id": "user_8421",
        "credit_type": "default",
        "balance": "12.5000",
        "reserved": "12.5000",
        "available": "12.5000",
        "allow_negative": true,
        "low_balance_threshold": "12.5000",
        "created_at": "2026-10-02T09:30:00Z",
        "updated_at": "2026-10-02T09:30:00Z"
      }
    ],
    "created_at": "2026-10-02T09:30:00Z",
    "updated_at": "2026-10-02T09:30:00Z"
  }
}

{
  "allow_negative": true,
  "low_balance_threshold": "12.5000"
}

{
  "data": {
    "customer_account_id": "74438200973594624",
    "customer_id": "74438200973594624",
    "project_id": "74438200973594624",
    "external_user_id": "user_8421",
    "credit_type": "default",
    "balance": "12.5000",
    "reserved": "12.5000",
    "available": "12.5000",
    "allow_negative": true,
    "low_balance_threshold": "12.5000",
    "created_at": "2026-10-02T09:30:00Z",
    "updated_at": "2026-10-02T09:30:00Z"
  }
}

{
  "data": {
    "customer_account_id": "74438200973594624",
    "customer_id": "74438200973594624",
    "project_id": "74438200973594624",
    "external_user_id": "user_8421",
    "credit_type": "default",
    "balance": "12.5000",
    "reserved": "12.5000",
    "available": "12.5000",
    "allow_negative": true,
    "low_balance_threshold": "12.5000",
    "created_at": "2026-10-02T09:30:00Z",
    "updated_at": "2026-10-02T09:30:00Z"
  }
}

{
  "reason": "string"
}

{
  "data": {
    "customer_id": "74438200973594624",
    "external_user_id": "user_8421",
    "status": "active",
    "blocked_at": "2026-10-02T09:30:00Z",
    "block_reason": "string",
    "accounts": [
      {
        "customer_account_id": "74438200973594624",
        "customer_id": "74438200973594624",
        "project_id": "74438200973594624",
        "external_user_id": "user_8421",
        "credit_type": "default",
        "balance": "12.5000",
        "reserved": "12.5000",
        "available": "12.5000",
        "allow_negative": true,
        "low_balance_threshold": "12.5000",
        "created_at": "2026-10-02T09:30:00Z",
        "updated_at": "2026-10-02T09:30:00Z"
      }
    ],
    "created_at": "2026-10-02T09:30:00Z",
    "updated_at": "2026-10-02T09:30:00Z"
  }
}

{}

{
  "data": {
    "customer_id": "74438200973594624",
    "external_user_id": "user_8421",
    "status": "active",
    "blocked_at": "2026-10-02T09:30:00Z",
    "block_reason": "string",
    "accounts": [
      {
        "customer_account_id": "74438200973594624",
        "customer_id": "74438200973594624",
        "project_id": "74438200973594624",
        "external_user_id": "user_8421",
        "credit_type": "default",
        "balance": "12.5000",
        "reserved": "12.5000",
        "available": "12.5000",
        "allow_negative": true,
        "low_balance_threshold": "12.5000",
        "created_at": "2026-10-02T09:30:00Z",
        "updated_at": "2026-10-02T09:30:00Z"
      }
    ],
    "created_at": "2026-10-02T09:30:00Z",
    "updated_at": "2026-10-02T09:30:00Z"
  }
}

{
  "data": [
    {
      "entry_id": "74438200973594624",
      "customer_account_id": "74438200973594624",
      "external_user_id": "user_8421",
      "credit_type": "default",
      "entry_type": "hold",
      "credits": "12.5000",
      "balance_after": "12.5000",
      "available_after": "12.5000",
      "reservation_id": "74438200973594624",
      "note": "string",
      "created_at": "2026-10-02T09:30:00Z"
    }
  ],
  "meta": {
    "limit": 1,
    "next_cursor": "string"
  }
}

{
  "credits": "12.5000",
  "credit_type": "default",
  "note": "string"
}

{
  "data": {
    "customer_account_id": "74438200973594624",
    "customer_id": "74438200973594624",
    "project_id": "74438200973594624",
    "external_user_id": "user_8421",
    "credit_type": "default",
    "balance": "12.5000",
    "reserved": "12.5000",
    "available": "12.5000",
    "allow_negative": true,
    "low_balance_threshold": "12.5000",
    "created_at": "2026-10-02T09:30:00Z",
    "updated_at": "2026-10-02T09:30:00Z"
  }
}

{
  "credits": "12.5000",
  "credit_type": "default",
  "note": "string"
}

{
  "data": {
    "customer_account_id": "74438200973594624",
    "customer_id": "74438200973594624",
    "project_id": "74438200973594624",
    "external_user_id": "user_8421",
    "credit_type": "default",
    "balance": "12.5000",
    "reserved": "12.5000",
    "available": "12.5000",
    "allow_negative": true,
    "low_balance_threshold": "12.5000",
    "created_at": "2026-10-02T09:30:00Z",
    "updated_at": "2026-10-02T09:30:00Z"
  }
}

{
  "credits": "12.5000",
  "credit_type": "default",
  "note": "string"
}

{
  "data": {
    "customer_account_id": "74438200973594624",
    "customer_id": "74438200973594624",
    "project_id": "74438200973594624",
    "external_user_id": "user_8421",
    "credit_type": "default",
    "balance": "12.5000",
    "reserved": "12.5000",
    "available": "12.5000",
    "allow_negative": true,
    "low_balance_threshold": "12.5000",
    "created_at": "2026-10-02T09:30:00Z",
    "updated_at": "2026-10-02T09:30:00Z"
  }
}

{
  "data": [
    {
      "credit_price_id": "74438200973594624",
      "project_id": "74438200973594624",
      "operation_code": "generate_email",
      "credit_type": "default",
      "credits": "12.5000",
      "created_at": "2026-10-02T09:30:00Z",
      "updated_at": "2026-10-02T09:30:00Z"
    }
  ]
}

{
  "operation_code": "generate_email",
  "credits": "12.5000",
  "credit_type": "default"
}

{
  "data": {
    "credit_price_id": "74438200973594624",
    "project_id": "74438200973594624",
    "operation_code": "generate_email",
    "credit_type": "default",
    "credits": "12.5000",
    "created_at": "2026-10-02T09:30:00Z",
    "updated_at": "2026-10-02T09:30:00Z"
  }
}

Примеры

Найти клиентов, у которых заканчиваются кредиты

low_balance оставляет клиентов, у которых есть счёт, где доступно меньше 20 кредитов. У этого клиента на балансе 18, и 4 из них зарезервированы.

curl "https://api.slen.ai/api/v1/customers?low_balance=20" \
  -H "Authorization: Bearer $SLEN_API_KEY"

{
  "data": [
    {
      "customer_id": "74439840149372928",
      "external_user_id": "user_3107",
      "status": "active",
      "blocked_at": null,
      "block_reason": null,
      "accounts": [
        {
          "customer_account_id": "74439840153567232",
          "customer_id": "74439840149372928",
          "project_id": "74438200973594624",
          "external_user_id": "user_3107",
          "credit_type": "default",
          "balance": "18.0000",
          "reserved": "4.0000",
          "available": "14.0000",
          "allow_negative": false,
          "low_balance_threshold": "0.0000",
          "created_at": "2026-09-28T11:02:17+00:00",
          "updated_at": "2026-10-02T08:39:51+00:00"
        }
      ],
      "created_at": "2026-09-28T11:02:17+00:00",
      "updated_at": "2026-10-02T08:39:51+00:00"
    }
  ],
  "meta": {
    "limit": 50,
    "next_cursor": null
  }
}

Прочитать клиента

У клиента один счёт, типа кредитов default. Движение, которое опускает его available ниже 10, отправляет customer.balance_low.

curl https://api.slen.ai/api/v1/customers/user_8421 \
  -H "Authorization: Bearer $SLEN_API_KEY"

{
  "data": {
    "customer_id": "74439117522108416",
    "external_user_id": "user_8421",
    "status": "active",
    "blocked_at": null,
    "block_reason": null,
    "accounts": [
      {
        "customer_account_id": "74439117526302720",
        "customer_id": "74439117522108416",
        "project_id": "74438200973594624",
        "external_user_id": "user_8421",
        "credit_type": "default",
        "balance": "82.5000",
        "reserved": "0.0000",
        "available": "82.5000",
        "allow_negative": false,
        "low_balance_threshold": "10.0000",
        "created_at": "2026-10-02T08:40:30+00:00",
        "updated_at": "2026-10-02T09:20:05+00:00"
      }
    ],
    "created_at": "2026-10-02T08:40:00+00:00",
    "updated_at": "2026-10-02T08:40:00+00:00"
  }
}

Добавить клиента

Тело пустое. Клиент новый, поэтому ответ — 201, а accounts пуст, пока пополнение или настройки не создадут счёт.

curl -X PUT https://api.slen.ai/api/v1/customers/user_8421 \
  -H "Authorization: Bearer $SLEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

{
  "data": {
    "customer_id": "74439117522108416",
    "external_user_id": "user_8421",
    "status": "active",
    "blocked_at": null,
    "block_reason": null,
    "accounts": [],
    "created_at": "2026-10-02T08:40:00+00:00",
    "updated_at": "2026-10-02T08:40:00+00:00"
  }
}

Удалить клиента

Этого клиента добавили и ни разу не пополнили, поэтому клиент удаляется. У ответа нет тела.

curl -X DELETE https://api.slen.ai/api/v1/customers/user_9050 \
  -H "Authorization: Bearer $SLEN_API_KEY"

Настроить счёт

Настройки создают счёт типа кредитов default с предупреждением ниже 10 кредитов. Счёт не может уйти ниже нуля.

curl -X PUT https://api.slen.ai/api/v1/customers/user_8421/accounts/default \
  -H "Authorization: Bearer $SLEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "allow_negative": false,
    "low_balance_threshold": "10"
  }'

{
  "data": {
    "customer_account_id": "74439117526302720",
    "customer_id": "74439117522108416",
    "project_id": "74438200973594624",
    "external_user_id": "user_8421",
    "credit_type": "default",
    "balance": "0.0000",
    "reserved": "0.0000",
    "available": "0.0000",
    "allow_negative": false,
    "low_balance_threshold": "10.0000",
    "created_at": "2026-10-02T08:40:30+00:00",
    "updated_at": "2026-10-02T08:40:30+00:00"
  }
}

Заблокировать клиента

Причина видна как block_reason. Счета сохраняют свои кредиты.

curl https://api.slen.ai/api/v1/customers/user_8421/block \
  -H "Authorization: Bearer $SLEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "reason": "Chargeback on invoice 1042"
  }'

{
  "data": {
    "customer_id": "74439117522108416",
    "external_user_id": "user_8421",
    "status": "blocked",
    "blocked_at": "2026-10-02T09:31:10+00:00",
    "block_reason": "Chargeback on invoice 1042",
    "accounts": [
      {
        "customer_account_id": "74439117526302720",
        "customer_id": "74439117522108416",
        "project_id": "74438200973594624",
        "external_user_id": "user_8421",
        "credit_type": "default",
        "balance": "82.5000",
        "reserved": "0.0000",
        "available": "82.5000",
        "allow_negative": false,
        "low_balance_threshold": "10.0000",
        "created_at": "2026-10-02T08:40:30+00:00",
        "updated_at": "2026-10-02T09:20:05+00:00"
      }
    ],
    "created_at": "2026-10-02T08:40:00+00:00",
    "updated_at": "2026-10-02T09:31:10+00:00"
  }
}

Разблокировать клиента

У запроса нет тела. Клиент снова active, а blocked_at и block_reason очищены.

curl -X POST https://api.slen.ai/api/v1/customers/user_8421/unblock \
  -H "Authorization: Bearer $SLEN_API_KEY"

{
  "data": {
    "customer_id": "74439117522108416",
    "external_user_id": "user_8421",
    "status": "active",
    "blocked_at": null,
    "block_reason": null,
    "accounts": [
      {
        "customer_account_id": "74439117526302720",
        "customer_id": "74439117522108416",
        "project_id": "74438200973594624",
        "external_user_id": "user_8421",
        "credit_type": "default",
        "balance": "82.5000",
        "reserved": "0.0000",
        "available": "82.5000",
        "allow_negative": false,
        "low_balance_threshold": "10.0000",
        "created_at": "2026-10-02T08:40:30+00:00",
        "updated_at": "2026-10-02T09:20:05+00:00"
      }
    ],
    "created_at": "2026-10-02T08:40:00+00:00",
    "updated_at": "2026-10-02T10:02:00+00:00"
  }
}

Прочитать выписку клиента

В ответе три движения, самое новое — первым: списание за выгрузку, корректировка, которая сняла 12.5 кредита, и пополнение перед ними.

curl https://api.slen.ai/api/v1/customers/user_8421/entries \
  -H "Authorization: Bearer $SLEN_API_KEY"

{
  "data": [
    {
      "entry_id": "74439673397166080",
      "customer_account_id": "74439117526302720",
      "external_user_id": "user_8421",
      "credit_type": "default",
      "entry_type": "charge",
      "credits": "-5.0000",
      "balance_after": "82.5000",
      "available_after": "82.5000",
      "reservation_id": null,
      "note": "PDF export 311",
      "created_at": "2026-10-02T09:20:05+00:00"
    },
    {
      "entry_id": "74439652312547328",
      "customer_account_id": "74439117526302720",
      "external_user_id": "user_8421",
      "credit_type": "default",
      "entry_type": "adjust",
      "credits": "-12.5000",
      "balance_after": "87.5000",
      "available_after": "87.5000",
      "reservation_id": null,
      "note": null,
      "created_at": "2026-10-02T09:15:42+00:00"
    },
    {
      "entry_id": "74439117530497024",
      "customer_account_id": "74439117526302720",
      "external_user_id": "user_8421",
      "credit_type": "default",
      "entry_type": "topup",
      "credits": "100.0000",
      "balance_after": "100.0000",
      "available_after": "100.0000",
      "reservation_id": null,
      "note": "Invoice 1042",
      "created_at": "2026-10-02T08:41:00+00:00"
    }
  ],
  "meta": {
    "limit": 30,
    "next_cursor": null
  }
}

Пополнить клиента

Ключ называет это пополнение, и повтор с тем же ключом ничего не добавляет. Примечание называет счёт на оплату, по которому оно оплачено.

curl https://api.slen.ai/api/v1/customers/user_8421/topup \
  -H "Authorization: Bearer $SLEN_API_KEY" \
  -H "Idempotency-Key: topup-user_8421-invoice-1042" \
  -H "Content-Type: application/json" \
  -d '{
    "credits": "100",
    "note": "Invoice 1042"
  }'

{
  "data": {
    "customer_account_id": "74439117526302720",
    "customer_id": "74439117522108416",
    "project_id": "74438200973594624",
    "external_user_id": "user_8421",
    "credit_type": "default",
    "balance": "100.0000",
    "reserved": "0.0000",
    "available": "100.0000",
    "allow_negative": false,
    "low_balance_threshold": "10.0000",
    "created_at": "2026-10-02T08:40:30+00:00",
    "updated_at": "2026-10-02T08:41:00+00:00"
  }
}

Скорректировать баланс

Отрицательная сумма снимает кредиты.

curl https://api.slen.ai/api/v1/customers/user_8421/adjust \
  -H "Authorization: Bearer $SLEN_API_KEY" \
  -H "Idempotency-Key: adjust-user_8421-refund-77" \
  -H "Content-Type: application/json" \
  -d '{
    "credits": "-12.5"
  }'

{
  "data": {
    "customer_account_id": "74439117526302720",
    "customer_id": "74439117522108416",
    "project_id": "74438200973594624",
    "external_user_id": "user_8421",
    "credit_type": "default",
    "balance": "87.5000",
    "reserved": "0.0000",
    "available": "87.5000",
    "allow_negative": false,
    "low_balance_threshold": "10.0000",
    "created_at": "2026-10-02T08:40:30+00:00",
    "updated_at": "2026-10-02T09:15:42+00:00"
  }
}

Списать с клиента

Ваше приложение снимает 5 кредитов за сделанную выгрузку. Ключ называет выгрузку, поэтому повтор больше ничего не снимает.

curl https://api.slen.ai/api/v1/customers/user_8421/charge \
  -H "Authorization: Bearer $SLEN_API_KEY" \
  -H "Idempotency-Key: charge-user_8421-export-311" \
  -H "Content-Type: application/json" \
  -d '{
    "credits": "5",
    "note": "PDF export 311"
  }'

{
  "data": {
    "customer_account_id": "74439117526302720",
    "customer_id": "74439117522108416",
    "project_id": "74438200973594624",
    "external_user_id": "user_8421",
    "credit_type": "default",
    "balance": "82.5000",
    "reserved": "0.0000",
    "available": "82.5000",
    "allow_negative": false,
    "low_balance_threshold": "10.0000",
    "created_at": "2026-10-02T08:40:30+00:00",
    "updated_at": "2026-10-02T09:20:05+00:00"
  }
}

Получить список цен в кредитах

У проекта одна цена.

curl https://api.slen.ai/api/v1/credit-prices \
  -H "Authorization: Bearer $SLEN_API_KEY"

{
  "data": [
    {
      "credit_price_id": "74440031913676800",
      "project_id": "74438200973594624",
      "operation_code": "generate_email",
      "credit_type": "default",
      "credits": "2.0000",
      "created_at": "2026-10-02T08:30:00+00:00",
      "updated_at": "2026-10-02T08:30:00+00:00"
    }
  ]
}

Задать цену в кредитах

Начиная со следующего холда один вызов модели в этой операции стоит клиенту два кредита.

curl -X PUT https://api.slen.ai/api/v1/credit-prices \
  -H "Authorization: Bearer $SLEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "operation_code": "generate_email",
    "credits": "2"
  }'

{
  "data": {
    "credit_price_id": "74440031913676800",
    "project_id": "74438200973594624",
    "operation_code": "generate_email",
    "credit_type": "default",
    "credits": "2.0000",
    "created_at": "2026-10-02T08:30:00+00:00",
    "updated_at": "2026-10-02T08:30:00+00:00"
  }
}

Что читать дальше

• Кредиты клиентов — те же клиенты в консоли.

• Клиенты и кредиты — те же операции из SDK.

• Аналитика — кредиты, списанные с ваших клиентов, против того, сколько стоили их вызовы.

• Аутентификация — разрешения, которые нужны ключу, чтобы читать и менять клиентов.

• Обзор — как кредиты записываются в запросе и в ответе.

• Коды ошибок — каждый код API: что он значит и что с ним делать.

• Вебхуки — как приходит customer.balance_low.