Paloma365 · Platform API песочница
Песочница для разработчиков Paloma365
Подключите свой сервис к ресторанам и магазинам на Paloma365 с согласия их владельцев: читайте каталог и заказы, создавайте заказы, принимайте онлайн-оплату заказов QR-меню как платёжная система. Всё самостоятельно — регистрация, ключи и тесты, без заявок и ожидания.
Для AI-ассистента разработчика
Дайте ему эту страницу: https://sandbox-api.paloma365.com/platform/ — или краткий указатель для AI-инструментов https://sandbox-api.paloma365.com/platform/llms.txt.
Шаги 1–3 (регистрация, создание приложения, согласие на доступ) делает человек в браузере, остальное — ваш сервис или AI через API.
Зарегистрируйте бесплатный тестовый бизнес
Это одновременно ваш аккаунт разработчика и тестовый ресторан: только тестовые данные, реальных денег нет.Создайте приложение — ключи сразу
Настройки → Разработчикам → «Создать приложение»: название, ссылки на политику конфиденциальности и условия, точные https-адреса возврата, нужные права. client_id и client_secret появятся сразу; секрет показывается один раз — храните его на своём сервере.Подключите бизнес по OAuth
Владелец открывает ссылку подключения из карточки вашего приложения и нажимает «Разрешить» (в песочнице владелец — вы). Ваше приложение обменивает код на токены: руководство, раздел 3.Адреса:
https://sandbox-api.paloma365.com/platform/oauth/authorize,https://sandbox-api.paloma365.com/platform/oauth/tokenВызывайте API
Токен — в заголовке Authorization: Bearer …, адрес API —https://sandbox-api.paloma365.com/platform/v1. Справочник методов, OpenAPI.Платёжным системам: банкам, эквайерам, шлюзам
В карточке приложения нажмите «Сделать платёжной системой» — секрет подписи ppss_… выдаётся сразу. Мы присылаем на ваш адрес подписанные сессии оплаты, вы подтверждаете или отклоняете оплату. Тестовые сессии по запросу, с автоматической проверкой вашего адреса, и отчёт о готовности в карточке приложения:POST https://sandbox-api.paloma365.com/platform/v1/sandbox/payment-sessions. Руководство, разделы 9.6–9.7.Выход в прод
Когда интеграция готова, создайте приложение заново в кабинете своего рынка — продовые ключи отдельные: dashboard.paloma365.com · dashboard.palomapos.com. Если раздел «Разработчикам» там пишет, что консоль недоступна, рынок ещё не открыт для приложений — напишите нам.
Важно
- В песочнице только тестовые бизнесы и данные; сессии оплаты помечены "test": true.
- Она работает на свежем коде и может перезапускаться — SLA нет.
- Ключи песочницы работают только в песочнице; продовые создаются отдельно.
- Храните client_secret и секрет подписи только на своём сервере.