--- title: API-токен description: "Токен для публічного API IBAN oplata: де в кабінеті сторінка «API Токен», як згенерувати й скопіювати токен, де його безпечно зберігати, як перегенерувати без перерви в роботі інтеграції (старий токен діє ще 12 годин), як видалити токен і чому API може приймати видалений токен ще кілька годин, що означають помилки доступу." audience: seller plans: - trial - premium addons: [] availability: ga verified: 2026-10-10 canonical: https://ibanoplata.com/help/integrations/api-token.html --- # API-токен > Доступно на ознайомчому періоді та тарифі Преміум API-токен — це ключ, яким ваш сайт, CRM чи власна програма підтверджує публічному API IBAN oplata, що запит іде від вашого кабінету. Токен створюється на сторінці **API Токен** однією кнопкою, не має терміну дії і працює, доки ви його не перегенеруєте або не видалите. У кабінету може бути лише один чинний токен; хто знає токен, той може створювати посилання на оплату від вашого імені, тож зберігайте його в таємниці. ## Де знайти сторінку «API Токен» {#open} 1. На широкому екрані натисніть кнопку з вашою поштою внизу бокової панелі кабінету. Відкриється меню акаунта. 2. У меню акаунта оберіть **API Token**. Відкриється сторінка «API Токен». 3. На телефоні відкрийте меню кнопкою в шапці кабінету й оберіть **API Токен** — відкриється та сама сторінка. Поки токена немає, сторінка показує «Ви ще не маєте створеного API Токена» і кнопку **Згенерувати Токен**. Внизу сторінки — адреса API і посилання на документацію Swagger; з чого почати роботу з API, описано в статті [Публічне API: з чого почати](https://ibanoplata.com/help/integrations/public-api.md). ## Створити токен {#create} 1. На сторінці **API Токен** натисніть **Згенерувати Токен**. У полі **Токен** зʼявиться новий токен, а поруч — кнопки **Перегенерувати** і **Копіювати**. ![Сторінка «API Токен»: поле «Токен» зі згенерованим токеном, кнопки «Перегенерувати», «Копіювати» і «Видалити Токен», нижче — адреса API і посилання на документацію Swagger](https://help-media.ibanoplata.com/2e7ed7bbb8811c6c5bb716879f1f3443a7a6d875909406c4eaa388b8b0118f0a.png) 2. Натисніть **Копіювати** (на вузькому екрані — лише іконка без підпису). Токен потрапить у буфер обміну, і зʼявиться повідомлення «Токен скопійовано». 3. Вставте токен у налаштування своєї інтеграції — туди, де ваша програма зберігає ключі доступу. Токен довгий, тому копіюйте його кнопкою **Копіювати**, а не виділенням: у полі видно лише початок токена, і обрізаний токен API не прийме. Повернутися по токен можна будь-коли — сторінка **API Токен** показує чинний токен щоразу, коли ви її відкриваєте. ## Де зберігати API-токен {#storage} API-токен дає доступ до посилань і реквізитів вашого кабінету, тому він має лишатися лише на вашому сервері: - тримайте токен у змінних оточення або в сховищі секретів вашого хостингу чи CRM, а не в коді, який бачать інші; - не вставляйте токен у код сторінок сайту, який виконується в браузері відвідувача, у мобільний застосунок чи в публічний репозиторій — звідти його може скопіювати будь-хто; - якщо у вашого сайту немає власного сервера, не намагайтеся звертатися до API з браузера — для такого випадку є динамічні посилання без токена, які налаштовує служба підтримки. Сторінку **API Токен** бачить кожен, хто має доступ до вашого кабінету, тож не діліться паролем від кабінету з тими, кому токен знати не потрібно. ## Перегенерувати токен {#regenerate} Перегенерація замінює токен на новий без перерви в роботі інтеграції: старий токен ще 12 годин працює паралельно з новим. Так варто робити, коли токен міг потрапити до сторонніх, але інтеграцію зупиняти не можна. 1. На сторінці **API Токен** натисніть **Перегенерувати** поруч із токеном. Відкриється вікно «Перегенерувати Токен» з попередженням, що старий токен залишатиметься активним ще 12 годин. 2. У вікні натисніть **Перегенерувати**. Вікно закриється, а в полі **Токен** зʼявиться новий токен. 3. Скопіюйте новий токен кнопкою **Копіювати** і замініть ним старий в усіх місцях, де працює інтеграція, протягом 12 годин. Кнопка **Скасувати** у вікні «Перегенерувати Токен» закриває його без змін. Не розраховуйте, що старий токен перестане працювати рівно через 12 годин: API памʼятає перевірені токени, тож старий токен може відповідати ще кілька годин після цього. ## Видалити токен {#delete} Видалення відключає токен без заміни: інтеграції, які ним користуються, перестануть працювати. Видаляйте токен, коли інтеграція більше не потрібна або коли токен потрапив до сторонніх і перехідний період вам не потрібен. 1. На сторінці **API Токен** натисніть **Видалити Токен**. Відкриється вікно «Видалити Токен» з попередженням, що видалення призведе до припинення роботи всіх підключень до API. 2. У вікні натисніть **Видалити Токен**. Поле з токеном зникне, сторінка покаже «Ви ще не маєте створеного API Токена» і кнопку **Згенерувати Токен**. 3. Якщо інтеграція ще потрібна, натисніть **Згенерувати Токен** і вставте новий токен у її налаштування. API перестає приймати видалений токен не завжди одразу: якщо токеном користувалися протягом останніх 12 годин, API може приймати його ще до 12 годин. Якщо токен потрапив до сторонніх і кожна година має значення, після видалення напишіть у підтримку. ## Якщо щось не так {#troubleshooting} - **API відповідає «Передплата закінчилася або ваш тариф не підтримує API-інтеграцію.»** Токен створюється на сторінці **API Токен**, але працює лише на тарифах, вказаних над цією статтею; на інших тарифах API відповідає цією помилкою доступу навіть на правильний токен. Оберіть відповідний тариф на сторінці **Мій тариф** — доступ зʼявиться протягом пʼяти хвилин. - **Кнопки на сторінці «API Токен» показують «Передплата закінчилася або ваш тариф не включає цей функціонал.»** Створювати, перегенеровувати й видаляти токен можна, поки триває платний або ознайомчий період, і ще кілька днів після його закінчення. Пізніше кабінет відмовляє, хоча чинний токен на сторінці видно. Поновіть передплату на сторінці **Мій тариф**. - **Зʼявляється «Токен уже згенеровано. Щоб згенерувати новий токен, деактивуйте наявний.»** Токен уже створено, наприклад в іншій вкладці браузера. Оновіть сторінку **API Токен** — на ній буде чинний токен; новий отримайте кнопкою **Перегенерувати**. - **API не приймає токен, хоча тариф підходить.** Токен скопійовано не повністю, токен видалено, або його перегенерували понад 12 годин тому і в інтеграції лишився старий. Скопіюйте чинний токен зі сторінки **API Токен** кнопкою **Копіювати**. - **Після копіювання зʼявляється «Помилка копіювання».** Браузер не дав сторінці записати текст у буфер обміну. Натисніть **Копіювати** ще раз або відкрийте кабінет в іншому браузері. ## Повʼязані статті {#related} - [Публічне API: з чого почати](https://ibanoplata.com/help/integrations/public-api.md). - [QR-код через пряме посилання](https://ibanoplata.com/help/integrations/qr-direct-link.md). - [Тарифи: що від них залежить](https://ibanoplata.com/help/billing/plans.md). - [Змінити тариф](https://ibanoplata.com/help/billing/change-plan.md).