Підключіть власні системи до TransferGo та отримуйте історію транзакцій автоматично — без необхідності входити в систему для перевірки.
Що таке TransferGo Бізнес API та що з ними можна робити?
Ми додаємо новий спосіб взаємодії з TransferGo: Бізнес API. Це дозволяє вашій компанії отримувати історію транзакцій безпосередньо з власних систем — вам не потрібно буде щоразу входити до вашого бізнес-акаунту TransferGo, щоб перевірити свої платежі.
Це особливо корисно, якщо:
- Ви регулярно звіряєте платежі: завантажуйте дані про транзакції безпосередньо у ваше власне бухгалтерське програмне забезпечення або систему ERP.
- У вас є команда розробників: підключіться один раз і дозвольте вашим системам виконувати перевірку за вас.
Наразі ця функція дозволяє переглянути лише історію активності вашого акаунту. Можливість надсилати платежі через API з'явиться пізніше цього року — ми одразу повідомимо вас.
Щоб отримати повне уявлення про можливості API, ознайомтеся з документацією для розробників.
Як почати підключення систем до TransferGo Бізнес API?
- Відкрийте API-інтеграції: Увійдіть до TransferGo Business і натисніть “API-інтеграції” у меню ліворуч.
- Розпочніть підключення: Натисніть “Погодитись і створити API-підключення”.
- Прийміть умови: Створення API-підключення вимагає прийняття наших оновлених Умов та положень.
Ви не Власник акаунта? В такому випадку ви не зможете підтвердити цей крок самостійно — ознайомтеся з наступною статтею, щоб дізнатися про наступні дії.
Схвалення API-підключення Власником акаунта
Якщо користувач акаунту починає налаштовувати API-підключення, але не є Власником, йому знадобиться ваше схвалення, перш ніж продовжити.
- Отримайте посилання для підтвердження: користувач акаунту надішле вам посилання для підтвердження підключення.
- Перегляньте та прийміть: Відкрийте посилання та прийміть оновлені Умови та положення.
- Готово: Після підтвердження користувач зможе продовжити налаштування сертифіката та підключення ваших систем.
Як згенерувати сертифікат і підключитися?
Після підтвердження з’єднання вам потрібно буде налаштувати клієнтський сертифікат, який забезпечить безпечне з’єднання ваших систем, а потім використати його для отримання токена доступу.
Основні факти, про які варто знати:
- Ваш приватний ключ генерується на вашому власному комп’ютері й ніколи не залишає його.
- Термін дії сертифікатів становить 1 рік.
- Токени доступу діють протягом 5 хвилин, тому зберігайте їх у кеші та використовуйте повторно, замість того щоб запитувати новий для кожного виклику.
- Завантаження запиту на підписання сертифіката (CSR) є відповідальним кроком, тому вам потрібно підтвердити його за допомогою пароля.
Як це зробити:
- Відкрийте розділ Інтеграції API і дотримуйтесь інструкції Як підключитися для вашої операційної системи (Windows або macOS/Linux).
- Виконайте вказані кроки, щоб згенерувати сертифікат, а потім отримайте токен доступу та перевірте з’єднання.
Застрягли на якомусь етапі? На екрані налаштування є посилання “Мені потрібна допомога”.
Точні команди, деталі сертифіката та запити на токени дивіться в посібнику з Автентифікації та Авторизації.
Як керувати моїми API-сертифікатами?
Ви можете керувати вашими сертифікатами в будь-який час у розділі API-інтеграції.
А. Завантаження вашого сертифіката
- Перейдіть до розділу API-інтеграції.
- Знайдіть свій сертифікат у таблиці та натисніть “Завантажити .CRT”.
Б. Додавання додаткового сертифіката
- Перейдіть до розділу API-інтеграції.
- Натисніть “Додати додатковий сертифікат”.
Це корисно, якщо ви хочете, щоб резервний сертифікат був готовий до закінчення терміну дії основного сертифіката.
В. Анулювання сертифіката
- Перейдіть до розділу API-інтеграції.
- Знайдіть сертифікат, який потрібно видалити, і натисніть піктограму анулювання поруч із ним.
- Підтвердьте видалення.
Після анулювання цей сертифікат більше не можна буде використовувати для підключення — перш ніж анулювати його, переконайтеся, що ваші системи від нього не залежать.
Важлива інформація: сертифікати дійсні протягом 1 року. Щоб здійснити зміну без затримок, додайте додатковий сертифікат до закінчення терміну дії основного, переведіть системи на нього, а потім скасуйте основний сертифікат.
Детальніше про закінчення терміну дії та заміну сертифікатів дивіться у розділі “Закінчення терміну дії та ротація сертифікатів”.
Що я можу отримати через TransferGo Бізнес API?
Після підключення ви зможете імпортувати дані про операції за вашим рахунком безпосередньо у власні системи. Це стосується переказів і поповнень рахунку, а також обміну валют, вкладів та зняття коштів, нарахування відсотків і коригування залишків.
Для кожної транзакції ви отримаєте такі деталі, як її статус, дату та час, суми й валюти, комісії, ваші коментарі, а також дані про відправника та одержувача, причому номери карток будуть замасковані з міркувань безпеки.
Результати розбиті на сторінки та мають можливість фільтрування, тому великі історії завантажуються невеликими частинами, зручними для опрацювання.
Наразі це лише для читання: ви можете отримувати дані, але поки що не можете здійснювати платежі через API. Ця функція планується до впровадження пізніше цього року.
Повний перелік полів, статусів та опцій фільтрування дивіться у статті про транзакції.