Где взять данные для интеграции с Инвойсбокс

Версий API две. Актуальная — v3, её данные живут в личном кабинете app.invoicebox.ru. Старая — l2 (в пути ссылки API; то же, что v2) — управляется в кабинете business.invoicebox.ru. Новые интеграции делаются на v3.

Эта страница — про то, где взять данные. Как ими пользоваться — в разделе Подключение к API: заголовок Authorization: Bearer и проверка токена — на странице авторизации, базовые URL и выбор версии — на обзорной.

Проведение тестовых платежей будет доступно после регистрации и создания магазина.

Примечание

Интеграция нужна не всегда: счёт можно выставить вручную прямо в кабинете — с QR-кодом для оплаты через СБП и отчётными документами. Это бесплатно, подробности и регистрация — на странице бесплатного выставления счёта.

Важно

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

API v3 (актуальная версия)

Ключи настраиваются в кабинете app.invoicebox.ru, раздел Мои продажи → Магазины → Интеграции. У версии v3 два секрета:

API токен — авторизация запросов, заголовок Authorization: Bearer <токен>;
API ключ — он же ключ подписи уведомлений: этим значением считается подпись входящего уведомления (заголовок X-Signature, метод hash_hmac). Алгоритм выбирается там же: у новых магазинов по умолчанию sha256, у настроенных раньше остаётся прежний — обычно sha1.

Тестовые данные (демо-магазин)

Идентификатор магазина - ffffffff-ffff-ffff-ffff-ffffffffffff
API токен (заголовок Authorization: Bearer) - b37c4c689295904ed21eee5d9a48d42e
API ключ / ключ подписи уведомлений (заголовок X-Signature) - 5a3797956281681be7cbb33ffc390ea1

Проверить обработчик уведомлений до первого настоящего платежа можно на странице обработки уведомлений — там контрольный пример подписи.

URL для уведомлений

Штатный способ — поле notificationUrl при создании заказа: адрес задаётся на каждый заказ. Постоянный адрес магазина задаётся в кабинете, сюда сервер Инвойсбокс будет отправлять запрос для подтверждения оплаты заказа:

для v3 — в разделе Мои продажи → Магазины → Интеграции кабинета app.invoicebox.ru;
для l2 — в разделе Мои продажи → Мои магазины → Интеграции (API) кабинета business.invoicebox.ru.

О том, как работает обработка уведомлений можно узнать здесь