Для AI-агентов: markdown этой страницы — /docs-content/entities/pay-systems/update.md индекс документации — /llms.txt

Изменить платёжную систему

PATCH /v1/pay-systems/:id

Изменяет отдельные поля платёжной системы. Поля передаются в корне JSON, без обёртки fields.

Параметры

Параметр Тип Обяз. Описание
id (path) integer да Положительное целое число, идентификатор платёжной системы. Источник: GET /v1/pay-systems.

Поля запроса (body)

Поле Тип Обяз. Описание
name string нет Новое название платёжной системы. Не может быть пустым.
personTypeId integer нет Идентификатор типа плательщика из GET /v1/person-types. Тип должен принадлежать реестру платёжной системы.
bxRestHandler string нет Код обработчика из поля code ответа GET /v1/pay-systems/handlers.
description string нет Описание платёжной системы.
active string нет Активность: Y — активна, N — неактивна.
newWindow string нет Открытие страницы оплаты в новом окне: Y или N.
xmlId string нет Внешний идентификатор.
logo array нет Логотип в формате [filename, base64]. Размер файла после декодирования — до 2 МиБ.

Передайте непустой объект JSON. Поля вне таблицы отклоняются.

Примеры

curl — личный ключ

Terminal 
curl -X PATCH "https://vibecode.bitrix24.tech/v1/pay-systems/41" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Оплата по счёту организации"
  }'

curl — OAuth-приложение

Terminal 
curl -X PATCH "https://vibecode.bitrix24.tech/v1/pay-systems/41" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Оплата по счёту организации"
  }'

JavaScript — личный ключ

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/pay-systems/41', {
  method: 'PATCH',
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Оплата по счёту организации"
  }),
})

const { success, data } = await res.json()

JavaScript — OAuth-приложение

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/pay-systems/41', {
  method: 'PATCH',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "Оплата по счёту организации"
  }),
})

const { success, data } = await res.json()

Поля ответа

HTTP 200. Возвращается обновлённая платёжная система.

Поле Тип Описание
success boolean Всегда true при успехе.
data object Обновлённая платёжная система. Полный состав: Поля платёжных систем.

Пример ответа

Показаны основные поля. Полный состав: Поля платёжных систем.

JSON 
{
  "success": true,
  "data": {
    "id": 41,
    "name": "Оплата по счёту организации",
    "actionFile": "my_payment_handler",
    "newWindow": "N",
    "active": "N",
    "entityRegistryType": "ORDER",
    "personTypeId": 5,
    "xmlId": "invoice-20261014"
  }
}

Пример ответа при ошибке

400 — в теле передано неподдерживаемое поле unexpected:

JSON 
{
  "success": false,
  "error": {
    "code": "READONLY_FIELD",
    "message": "Field 'unexpected' is not writable for this operation"
  }
}

Ошибки

HTTP Код Описание
400 INVALID_PARAMS id не является положительным целым числом, некорректный тип поля или формат логотипа.
400 MISSING_REQUIRED_FIELDS Пустое тело JSON или передан пустой name.
400 READONLY_FIELD В теле передано поле, недоступное для этой операции.
413 PAYLOAD_TOO_LARGE Логотип после декодирования превышает 2 МиБ либо тело JSON превышает 3 МиБ.
404 ENTITY_NOT_FOUND Платёжная система не найдена при изменении или последующем чтении.
403 BITRIX_ACCESS_DENIED Недостаточно прав, запись встроенная или OAuth-приложение не владеет обработчиком.
422 BITRIX_ERROR Бизнес-ошибка. Подробности — в error.message.
502 BITRIX_RESPONSE_INVALID Некорректная структура ответа на операцию или последующее чтение.
403 SCOPE_DENIED API-ключ не имеет скоупа pay_system.
403 WRITE_BLOCKED_READONLY_KEY Ключ разрешает только чтение.
401 TOKEN_MISSING У ключа нет настроенных данных доступа к Битрикс24.

Полный список общих ошибок API — Коды ошибок.

Смотрите также