← На главную · Нужны не технические детали? Как работает система

Интеграция с ПЛАТИМ

Документ для разработчиков интернет-магазина партнёра: как подключить витрину к Системе, сначала на песочнице, затем на production. Ключ API — только на сервере ИМ. Менеджеру партнёра удобнее начать со страницы «Партнёрам».

Два контура: sandbox → production

Один код интеграции. Сначала настраиваете sandbox, проходите чеклист, затем переключаете URL и ключ на production — без смены модуля.

	Sandbox	Production
Платформа / виджет	`https://app.demo.pla.team`	`https://pla.team`
Partner API	`https://app.demo.pla.team/api/v0`	`https://pla.team/api/v0`
Редиректор go	`https://go.demo.pla.team`	`https://go.pla.team`
Ключ API	sandbox-ключ от Агента	боевой ключ (отдельный)

Получите у Агента код партнёра, sandbox-ключ и whitelist origin вашей витрины.
Подключите виджет / модуль к sandbox (таблица выше).
Пройдите чеклист приёмки на sandbox.
Для боя смените только настройки: origin платформы, API base, go, ключ. Sandbox-ключ в production-сборку не класть.

Модуль 1С-Битрикс

Готовый адаптер plateam.partner: виджет, плитки СЭС/УЭС в корзине, hold/paid через события Sale. Исходники и установка — в репозитории:

Репозиторий Bitrix-модуля INSTALL.md

Clone или Download ZIP с GitHub → скопировать modules/plateam.partner в /local/modules/.
Админка → Marketplace → Установленные решения → установить (компоненты уйдут в /local/components/plateam).
Настройки модуля — сначала sandbox: platform_origin=https://app.demo.pla.team, соответствующий API base и ключ. Кнопка «Проверить ключ».
В шаблон: plateam:widget; в корзину: plateam:checkout.
После приёмки — те же поля на production (https://pla.team и боевой ключ).

Универсальный путь (не Bitrix)

На любой CMS: JS-виджет + server-to-server Partner API. Путь «только реф без UI сертификатов в корзине» запрещён.

Виджет (sandbox)

<script
  src="https://app.demo.pla.team/widget.js"
  data-partner="КОД_ПАРТНЁРА"
  data-app="https://app.demo.pla.team"
  async
></script>

На production замените origin на https://pla.team. В разметке — только код партнёра, не API-ключ.

Сервер ИМ

Auth: Authorization: Bearer <api_key>
Операции с бэкенда: hold, POST /orders/paid, POST /orders/cancelled
Правило сумм (копейки): orderTotal = cash + ses + ues; скидка должна быть в сумме заказа CMS, не только в UI

Чеклист приёмки (кратко)

W1 — виджет с data-partner и data-app контура
W4 — плитки СЭС/УЭС и скидка в сумме заказа
A1 — GET /partners/me с сервера → 200
A3 — hold + paid: сертификаты списаны/выпущены
A8 — ключ не в HTML/JS/репозитории
S1 — sandbox-ключ не в production-сборке

Полный список — в §10 полного ТЗ.

Полное техническое задание

Черновик Приложения №2 к договору: роли, безопасность, виджет, Partner API v0, данные, тестовый контур, чеклист.

Скачать ТЗ (.md)Открыть в браузере

Support: support@pla.team