# Платёжные системы

Выбирайте систему для оплаты заказов и счетов. Создавайте свои записи на уже зарегистрированном REST-обработчике. Скоуп: `pay_system`.

Встроенные платёжные системы доступны для чтения. Изменять и удалять можно только записи на REST-обработчиках. Для OAuth-приложения дополнительно проверяется владение обработчиком. Одного скоупа `sale` недостаточно.

## Операции

- [Список](./pay-systems/list.md) — `GET /v1/pay-systems`
- [Получить](./pay-systems/get.md) — `GET /v1/pay-systems/:id`
- [Создать](./pay-systems/create.md) — `POST /v1/pay-systems`
- [Изменить](./pay-systems/update.md) — `PATCH /v1/pay-systems/:id`
- [Удалить](./pay-systems/delete.md) — `DELETE /v1/pay-systems/:id`
- [Обработчики](./pay-systems/handlers.md) — `GET /v1/pay-systems/handlers`

## Ключевые поля

`id` передавайте в `paySystemId` оплаты. Значение `bxRestHandler` — поле `code` из [списка обработчиков](./pay-systems/handlers.md). Платёжный список не возвращает логотип.

[Все поля](./pay-systems/fields.md).

## Что нужно знать перед работой

Обработчики регистрируются отдельно: эти маршруты только читают их определения. `active` и `newWindow` используют строки `Y`/`N`, а не `boolean`.

Без `active` новая платёжная система неактивна (`N`). Если `entityRegistryType` не передан и на портале установлена CRM, используется `CRM_INVOICE`. Для заказов передайте `ORDER` и тип плательщика этого реестра.

## Типичный сценарий

Прочитайте [список обработчиков](./pay-systems/handlers.md), выберите `code`, создайте неактивную платёжную систему, получите её, измените `name`, затем удалите только свою запись. После успешной записи перечитывание может отказать: не повторяйте создание вслепую.

## Лимиты

Списки полные, без `limit` и `offset`. `meta.total` равен длине `data`. Логотип: `logo` — массив `[filename, base64]`, до 2 МиБ после декодирования. Тело JSON — до 3 МиБ. `settings` принимается только при создании.

## Что можно менять

| Запись | GET | PATCH / DELETE |
|---|---|---|
| Встроенная | Да | 403 |
| REST | Да | По правам Битрикс24 и владельцу OAuth-приложения |

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

- [Оплаты](/docs/entities/payments)
- [Оплаты CRM](/docs/entities/crm-payments)