Разработчикам

Раздел для компаний, которые делают сервисы для ресторанов и магазинов: платёжных систем, сервисов доставки, аналитики. Здесь вы сами регистрируете своё приложение и сразу получаете ключи к Platform API — без заявки и без ожидания команды Paloma365. Подключить приложение к чужому бизнесу может только владелец этого бизнеса, на экране подтверждения.

Всё по шагам, со ссылками и для вашего AI-ассистента — на стартовой странице: https://sandbox.paloma365.com/developers.

Если вам нужен ключ только к своему бизнесу — для своих скриптов или таблиц, — регистрировать приложение не нужно: создайте свою интеграцию.

Как открыть

Настройки → раздел Интеграции → Разработчикам (/settings/developer-apps).

Создавать и менять приложения может только владелец аккаунта. Сотрудник видит список приложений без кнопок.

Сначала песочница, потом боевой кабинет

	Песочница	Боевой кабинет
Личный кабинет	https://sandbox.paloma365.com	https://dashboard.paloma365.com (СНГ), https://dashboard.palomapos.com (США)
Адрес API	https://sandbox-api.paloma365.com/platform/v1	https://alfaposapi.paloma365.com/platform/v1 (СНГ), https://alfaposapi.palomapos.com/platform/v1 (США)
Аккаунт	бесплатный тестовый бизнес: зарегистрируйте его на https://sandbox.paloma365.com/register — он же ваш аккаунт разработчика и тестовый ресторан	ваш обычный аккаунт на рынке
Ключи	ключи песочницы, работают только в ней	свои ключи, с ключами песочницы не совпадают
Деньги	реальных денег нет	реальные бизнесы и реальные деньги

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

Поля приложения

Поле	Описание	Обязательное
Ключ приложения	2–40 символов: строчные латинские буквы, цифры, _ и -, начинается с буквы. Им помечаются заказы, которые создаёт приложение. Изменить нельзя	Да
Название	Видит владелец бизнеса на экране подтверждения и в списке подключённых приложений	Да
Разработчик (компания)	Кто сделал приложение	Да
Описание	Пара предложений о приложении	Нет
Ссылка на логотип	Адрес картинки, только https://	Нет
Политика конфиденциальности, Условия использования	Ссылки https:// на ваши документы	Да
Адреса возврата OAuth	Точные https:// адреса, по одному в строке; без масок	Да
Права	Что приложение может запросить у владельца. Владелец может согласиться на меньшее	Да

Как создать приложение

1. Нажмите Создать приложение и заполните поля.
2. Нажмите Создать — откроется окно с client_id и client_secret.
3. Скопируйте client_secret и сохраните его на своём сервере. Секрет показывается один раз: после закрытия окна его нельзя посмотреть, можно только выпустить новый.
4. Подключите приложение к бизнесу: владелец открывает ссылку подключения из карточки приложения и нажимает Разрешить. Значения state и code_challenge ваше приложение подставляет само для каждого подключения.

Платёжная система

Если ваше приложение принимает оплату онлайн-заказов QR-меню (например, через Kaspi QR):

1. Добавьте приложению право Приём оплаты онлайн-заказов как платёжная система (payments:process) — кнопка Изменить.
2. Нажмите Сделать платёжной системой и укажите адрес, на который PalomaPOS будет присылать сессии оплаты (https://, доменное имя, порт 443), способы оплаты, валюты и пробиваете ли вы фискальный чек сами.
3. Сохраните секрет подписи — он тоже показывается один раз. Им ваш сервис проверяет подпись каждого запроса.

В песочнице под платёжной системой виден блок Проверки песочницы: подключено ли приложение к вашему тестовому бизнесу, правильно ли ваш сервис проверяет подпись, отвечает на сессии, подтверждает и отклоняет оплату. Тестовые сессии заказывает ваш сервис через API. Когда все проверки пройдены, блок покажет Готово — можно выходить в боевой кабинет.

Общий список платёжных систем

Приложение, которое вы зарегистрировали сами, не попадает в общий список платёжных систем, который видят все бизнесы. Бизнес видит его в разделе QR Меню → Онлайн-заказы, только если его владелец сам подключил приложение по вашей ссылке. Чтобы приложение видели все бизнесы рынка, напишите команде Paloma365 и попросите проверку. После проверки в карточке появится отметка В общем списке.

Если изменить название, разработчика, описание или логотип проверенного приложения, оно уходит из общего списка до новой проверки.

Секреты, выключение и приостановка

• Новый секрет и Новый секрет подписи — старый секрет перестаёт работать сразу; новый показывается один раз.
• Выключить — ключи приложения перестают работать у всех подключённых бизнесов, пока вы его не включите.
• Приостановлено командой — команда Paloma365 остановила приложение, например после жалоб. Ключи не работают, включить его сами вы не можете — напишите команде.

Советы

• Храните client_secret и секрет подписи только на сервере, не в коде мобильного приложения или сайта.
• Дайте своему AI-ассистенту стартовую страницу https://sandbox.paloma365.com/developers или указатель https://sandbox-api.paloma365.com/platform/llms.txt — там весь порядок работы.
• Создать можно до 10 приложений на аккаунт.

FAQ

Нужно ли ждать одобрения команды?

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

Я потерял client_secret. Что делать?

Нажмите Новый секрет в карточке приложения и обновите секрет на своём сервере. Старый перестанет работать сразу.

Почему ключи песочницы не работают в боевом кабинете?

У песочницы и у каждого рынка свой реестр приложений. Создайте приложение заново в кабинете своего рынка — там будут свои ключи.