Контуры

Тестовый и боевой контур, чем различаются их ключи и что делать, когда контур закрыт.

У Plutera два контура: тестовый и боевой. В ответах API они называются TEST и LIVE. Тестовый нужен, чтобы написать и отладить интеграцию, боевой для настоящей работы.

Контур задаёт ключ

В запросе нет параметра «контур», и адрес API у обоих контуров один. Контур определяется ключом, которым подписан запрос.

Тестовый контурБоевой контур
Начало ключаak_test_ak_live_
Поле environment в ответахTESTLIVE
Адрес APIhttps://api.plutera.iohttps://api.plutera.io

Ключ одного контура не превращается в ключ другого: чтобы работать в обоих, нужны два ключа. Перепутать контуры настройкой адреса нельзя, перепутать можно только ключи. Держите тестовый и боевой ключ в разных хранилищах, а боевой выдавайте только боевому серверу.

Контур ключа видно по его началу и по ответу проверки ключа.

Что зависит от контура

Сегодня от контура зависит список сервисов: сервис попадает в него, только если готов к работе в контуре ключа. У тестового и боевого ключа одного мерчанта списки могут различаться, и это не ошибка.

Контур может быть закрыт

Контуры открывает мерчанту администратор, каждый отдельно.

Запрос ключом закрытого контура получает отказ 403 с правилом environment_closed. Ключ при этом верный, менять его не нужно. Если не в работе сам мерчант, правило будет merchant_not_active. Оба отказа описаны в каталоге отказов.

API v1 · собрано 12.11.2026 · выпуск cd63633

Справочник методов собирается из кода сервера: он не описывает адрес, которого нет.