Подключите свои собственные системы к TransferGo и получайте историю транзакций автоматически — для проверки не нужно входить в систему.
Что такое TransferGo Бизнес API и что я могу с ними делать?
Мы добавляем новый способ подключения к TransferGo: Бизнес API. Это позволяет вашей компании получать историю транзакций прямо из ваших собственных систем — больше нет необходимости входить в ваш бизнес-аккаунт TransferGo каждый раз, когда вы хотите проверить свои платежи.
Это особенно полезно, если:
- Вы регулярно составляете статистику платежей: выгружайте данные о транзакциях прямо в ваше собственное бухгалтерское ПО или ERP-систему.
- У вас есть команда разработчиков: подключитесь один раз и позвольте вашим системам выполнять проверку за вас.
На данный момент это включает только историю действий вашего аккаунта. Возможность отправлять платежи через API появится позже в этом году — мы обязательно сообщим вам.
Чтобы получить полное представление о возможностях API, ознакомьтесь с документацией для разработчиков.
Как начать подключение систем к TransferGo Бизнес API?
- Откройте интеграции API: Войдите в TransferGo Business и нажмите Интеграции API в меню слева.
- Начните подключение: Нажмите Согласиться и создать API-подключение.
- Примите условия: Создание API-подключения требует принятия наших обновленных Условий и положений.
Вы не являетесь Владельцем аккаунта? Вы не сможете подтвердить этот шаг самостоятельно — что делать в этом случае, читайте в следующей статье.
Одобрение API-подключения Владельцем аккаунта
Если пользователь бизнес аккаунта начинает настройку API-подключения, но не является Владельцем, ему потребуется ваше одобрение, прежде чем функция будет активирована.
- Получите ссылку для подтверждения: Пользователь бизнес аккаунта отправит вам ссылку для подтверждения подключения.
- Ознакомьтесь и примите: Откройте ссылку и примите обновленные Условия и положения.
- Готово: После подтверждения член вашей команды сможет продолжить настройку сертификата и подключение систем.
Как сгенерировать сертификат и подключиться?
Как только ваше подключение будет подтверждено, клиентский сертификат будет сгенерирован автоматически — именно он используется вашими системами для безопасного подключения.
Основные факты, которые нужно знать:
- Ваш закрытый ключ генерируется на вашем устройстве и никогда его не покидает.
- Сертификаты действительны в течение 1 года.
- Токены доступа действуют 5 минут, поэтому кэшируйте и используйте их повторно, вместо того чтобы запрашивать новый для каждого вызова.
- Загрузка запроса на подпись сертификата (CSR) — это чувствительная операция, поэтому вас попросят подтвердить её паролем.
Как сгенерировать сертификат:
- Откройте руководство по настройке: Нажмите “Как подключиться” рядом с вашим сертификатом.
- Выполните команду для вашей операционной системы (Windows или macOS/Linux), чтобы запросить токен доступа с помощью вашего сертификата.
Застряли на полпути? На экране настройки есть ссылка “Мне нужна помощь”.
Точные команды, сведения о сертификатах и запросы на токены вы можете проверить в разделе “Аутентификация и авторизация”.
Как управлять моими API-сертификатами?
Вы можете управлять вашими сертификатами в любое время в разделе Интеграции API.
A. Скачивание сертификата
- Перейдите в раздел Интеграции API.
- Найдите свой сертификат в таблице и нажмите “Скачать .CRT”
B. Добавление дополнительного сертификата
- Перейдите в раздел Интеграции API.
- Нажмите “Добавить дополнительный сертификат”.
Это полезно, если вы хотите иметь наготове резервный сертификат до истечения срока действия основного.
C. Отзыв сертификата
- Перейдите в раздел Интеграции API.
- Найдите сертификат, который хотите удалить, и нажмите на значок отзыва рядом с ним.
- Подтвердите удаление.
После отзыва этот сертификат больше нельзя будет использовать для подключения — перед его отзывом убедитесь, что ваши системы не зависят от него.
Важная информация: срок действия сертификатов составляет 1 год. Чтобы произвести замену без задержек, добавьте дополнительный сертификат до истечения срока действия основного, переключите системы на него, а затем отозвите основной сертификат.
Подробнее об истечении срока действия и замене сертификатов смотрите в разделе “Истечение срока действия и ротация сертификатов”.
Какую информацию я могу получить через TransferGo Бизнес API?
После подключения вы сможете импортировать данные о движении средств по счету непосредственно в свои системы. Сюда входят переводы и пополнения счета, а также обмен валют, вклады и снятие средств, начисление процентов и корректировки остатка.
По каждой транзакции вы получите такие сведения, как статус, дата и время, суммы и валюты, комиссии, ваши комментарии, а также данные отправителя и получателя; номера карт замаскированы в целях безопасности.
Результаты разбиты на страницы и их можно фильтровать, поэтому большие исторические данные загружаются удобными для работы частями.
На данный момент это только для чтения: вы можете получать данные, но пока не можете отправлять платежи через API. Эта возможность планируется к внедрению в конце этого года.
Полный список полей, статусов и параметров фильтрации вы можете проверить здесь.