Курсы обмена

S
Автор Sergiiy
Обновлено 1 год назад

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

 

О сторонних интеграциях.

Если вы решите использовать одну из сторонних интеграций для управления обменными курсами, важно отметить, что они поддерживаются третьей стороной, а не компанией Flysip Software. Изменения в стороннем приложении третьей стороной могут негативно повлиять на ваш бизнес. Возможно, что наши группы поддержки и разработки могут не знать о каких-либо проблемах, пока они не возникнут.

Мы постараемся сохранить два бесплатных варианта обмена валюты, поэтому, если сторонняя интеграция прекратит предоставление услуг обменного курса, у вас всегда будет более одного варианта для оперативных данных.

Поддерживаемые источники обменных курсов

Начиная с Flysip поддерживаются следующие источники обменных курсов:

  • Валютный слой (старый)

  • APILayer (новый CurrencyLayer)

  • АльфаВантаж

  • Пользовательский скрипт

  • Ручной ввод

 

Добавление нового обменного курса

  • Перейдите к окну «Обменный курс» в пользовательском интерфейсе Flysip. Ваш текущий список доступных валют будет указан в таблице, например, австралийский доллар (AUD), канадский доллар (CAD) и евро (EUR) на изображении ниже. Нажмите «Добавить», чтобы настроить дополнительные валюты.

  • При добавлении дополнительных обменных курсов выберите нужную денежную единицу в раскрывающемся меню. 

Вручную настройте курс, как указано в списке, или измените Source на Alpha Vantage ,  CurrencyLayer  или  APILayer . По состоянию на декабрь 2022 года все три провайдера требуют предоставления ключа API. Подробнее о том, как получить ключ API для конкретного провайдера, рассказано далее в этой статье. 

 



ПРИМЕЧАНИЕ. Когда обмен установлен как автоматический через веб-источник, отображаемые балансы будут меняться в зависимости от рыночной стоимости каждой валюты в прямой зависимости от ваших настроек базовой валюты. Это может привести к незначительным изменениям в выставлении счетов.

  • Выберите, Сохранить и закрыть, чтобы добавить настроенную валюту в список курсов обмена. Выбранная валюта (в приведенном выше примере фунт стерлингов, GBP) добавляется и будет заполнять раскрывающиеся списки Валюта для Тарифа, Наборов пунктов назначения, Поставщиков, CDR, Платежных процессоров, Ваучеров пополнения и т. д.

  • Столбец Timestamp отображает дату и время последнего обновления курса. Flysip автоматически обновляет обменные курсы через заданные промежутки времени. Alpha Vantage и CustomScript обновляют курс каждые 15 минут. Валютный слой и APILayer обновляются ежечасно с помощью бесплатной подписки.

  • Все валюты, отмеченные красным крестом справа,     в настоящее время не назначены объекту и поэтому могут быть удалены.

Ручной ввод

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

CurrencyLayer

Уровень валюты требует, чтобы вы подписались на ключ API и выбрали план подписки. Вам нужно будет создать учетную запись здесь . 

Бесплатный вариант поставляется с некоторыми небольшими оговорками. Пользователи ограничены 1000 запросами данных обменного курса в месяц, а базовой валютой, используемой для конвертации, является доллар США. На стороне запроса будет достаточно одного ключа API, так как при частоте опроса 1 в час коммутатор, скорее всего, достигнет только 744 запросов в месяц (за вычетом любых дополнительных запросов, которые могут иметь место, если вы проводите интенсивное тестирование). бесплатная версия также требует, чтобы в качестве базовой валюты был выбран доллар США.

Примечание. Регистрация новых аккаунтов на CurrencyLayer закрыта, а вместо этого новые пользователи перенаправляются на APILayer.

API-слой

Ex-CurrencyLayer. Обеспечивает большую гибкость в отношении доступных инструментов и рынок для добавления подписки на нужные модули в вашу учетную запись . Ограничения для бесплатной версии зависят от выбранной подписки, например, от 100 запросов в месяц. Flysip поддерживает следующий модуль курсов обмена: 

https://apilayer.com/marketplace/currency_data-api

Необходимо подписаться на этот модуль, после этого станет доступен API-ключ

АльфаВантаж

Alpha Vantage предоставляет бесплатные API-интерфейсы, с помощью которых пользователи могут получить доступ к широкому спектру данных, таких как обновления в реальном времени и исторические данные об акциях, валютах и ​​криптовалютах.

Некоторые из методов API бесплатны, для других требуется платная подписка. В частности, «Обменные курсы» долгое время были бесплатными, а затем стали платными. Начиная с Flysip 2021 можно указать собственный ключ API, который можно получить здесь: https://www.alphavantage.co/support/#api-key .  

Текущее состояние на декабрь 2022 г. — любой ключ API действителен для работы Alpha Vantage. 

Пользовательский сценарий:

Обменные курсы можно установить с помощью внешнего пользовательского скрипта. Скрипт должен быть создан (или загружен) на сервер как /var/envX/scripts/xrate_update_custom.sh, где envX должен быть заменен соответствующим i_environment, например, env123 или env1. Когда скрипт доступен на сервере, клиенты могут установить источник обновления обменного курса как Пользовательский скрипт.

Скрипт получает 2 аргумента: 

1. валюта (строка)

2. base_currency (строка)

Возвращаемые значения

курс (плавающий)

Возвращаемое значение следует читать как:

ставка N единиц base_currency за 1 единицу валюты (с плавающей запятой)

Пример такого скрипта, который повторно использует существующий источник курса обмена и дважды масштабирует его - ключ api_access_key следует заменить на действительный.

#!/bin/sh

#

# To activate custom exchange rates feature

# copy this script into /var/envX/scripts/xrate_update_custom.sh

#

# Scale AlphaVantage rate.

#

# Input arguments:

#       base currency

#       currency

# Returns:

#       exchange rate

SCRIPT="/home/ssp/scripts/xrate_update.py"

SCALE=2

RATE=`/home/ssp/scripts/python_exec.sh "${SCRIPT}" 1 AlphaVantage ${1} ${2} '{"api_access_key": "123"}'`

echo "${RATE} * ${SCALE}" | /usr/bin/bc -q

Оцените эту статью