Войдите в Портал Коммерсанта и перейдите в раздел Онлайн-платежей. Здесь вы найдёте ваш API-ключ и секрет для sandbox и продакшн-сред. Храните секретный ключ в безопасности и никогда не раскрывайте его в клиентском коде. Каждый магазин в вашем аккаунте может иметь собственный набор учётных данных.

Добавьте JavaScript SDK miaPOS на страницу оформления заказа или интегрируйтесь напрямую через REST API с вашего бэкенда. SDK обрабатывает отображение QR-кода, опрос статуса платежа и callback-уведомления. Для пользовательских интеграций API предоставляет эндпоинты для создания платёжных сессий, проверки статуса и обработки возвратов.

Используйте sandbox-среду для тестирования интеграции без обработки реальных денег. Sandbox имитирует полный платёжный поток, включая генерацию QR, сканирование клиентом и callback-уведомления о подтверждении платежа. Убедитесь, что ваш обработчик вебхуков корректно обрабатывает уведомления об успехе и ошибке перед запуском в продакшн.

После завершения тестирования переключите ваши API-учётные данные с sandbox на продакшн в Портале Коммерсанта. Обновите конфигурацию для использования продакшн-эндпоинта. Изменения в коде не требуются, если вы следовали документации SDK -- просто замените ключи и базовый URL.

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