Доповнення написані на базі фреймворку Laravel, детальну інформацію з встановлення та налаштування можна знайти на офіційному сайті.

Laravel

1) Зареєструйте нового бота, використовуючи бот "@botFather" та скопіюйте його токен (секретний ключ).

2) Використовуючи бот "@userinfobot" дізнайтеся та скопіюйте свій "ID" (ідентифікатор користувача).

API панелі керування

1) Згенеруйте секретний ключ у розділі "Налаштування додатка" - "Налаштування API панелі керування".

2) Заповніть список довірених IP-адрес.

Приватне API

1) Згенеруйте секретний ключ у розділі "Налаштування додатка" - "Налаштування приватного API".

2) Активуйте всі методи.

3) Заповніть список довірених IP-адрес.

Вебхуки

1) Згенеруйте секретний ключ у розділі "Налаштування додатка" - "Налаштування вебхуків".

2) Активуйте всі події.

3) Вкажіть хост.

https://ВАШ.ДОМЕН/api/webhooks/exchanger

Кастомний мерчант

1) Згенеруйте секретний ключ у розділі "Налаштування додатка" - "Налаштування кастомного мерчанта".

3) Вкажіть хост.

https://ВАШ.ДОМЕН/api/merchants/form

Кастомний парсер курсів

1) Згенеруйте секретний ключ у розділі "Налаштування додатка" - "Налаштування кастомного парсера курсів".

3) Вкажіть хост.

https://ВАШ.ДОМЕН/api/rates

Перед початком встановлення створіть текстовий файл і заповніть змінні оточення своїми даними. У файл також необхідно додати змінні оточення куплених доповнень.

Приклад заповнення:

APP_URL=https://ВАШ.ДОМЕН
APP_API_PREFIX=
APP_TIMEZONE=Europe/Kyiv
APP_LOCALE=uk
APP_KEY=

QUEUE_CONNECTION=sync

DB_DATABASE=exchanger_cms_addons
DB_USERNAME=user
DB_PASSWORD=12345

TELEGRAM_BOT_TOKEN=1234567890:AAF1gH8J2KlMnOpQrStUvWxYzAbCdEfGhIjK
TELEGRAM_ADMIN_CHAT_IDS=360634322

EXCHANGER_URL=https://demo.exchanger-cms.com
EXCHANGER_DASHBOARD_API_SECRET_KEY=Fa8aexee0ohK5ohziu2IePhal6shei9z
EXCHANGER_PRIVATE_API_SECRET_KEY=OR4iogohnah0meesiech5Ieb3aek9ohv
EXCHANGER_WEBHOOK_SECRET_KEY=iaGh4ja5jeiHu0YohSho9ju8vahch7ei
EXCHANGER_CUSTOM_MERCHANT_SECRET_KEY=euMeitoh6uuLeiwaiH6ogh3fahreepeS
EXCHANGER_CUSTOM_RATES_PARSER_SECRET_KEY=IekieKei7kohvai9shaos8ziewu2Ohqu

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

Значення за замовчуванням:

HTTP_CONNECT_TIMEOUT=3
HTTP_TIMEOUT=9

TELEGRAM_MAX_CONNECTIONS=1
TELEGRAM_SENDING_DELAY=500000
TELEGRAM_ERROR_REPORTING=true

EXCHANGER_USER_AGENT=EXCMSMA

1) Оформіть замовлення на покупку Telegram-бота.

2) Завантажте архів з файлами та розпакуйте його в кореневу директорію сайту.

3) Створіть файл ".env" (файл змінних оточення) і заповніть його підготовленими даними.

4) Встановіть залежності.

composer install --no-dev --optimize-autoloader --prefer-dist --no-interaction

5) Згенеруйте ключ застосунку.

php artisan key:generate

6) Виконайте міграцію бази даних.

php artisan migrate

7) Встановіть вебхук Telegram.

php artisan telegram:setup-webhook

8) Виконайте оптимізацію застосунку.

php artisan optimize

9) Налаштуйте планувальник завдань (CRON) для користувача "www-data" на виконання команди щохвилини:

* * * * * /usr/bin/php /var/www/ВАШ.ДОМЕН/artisan schedule:run >> /dev/null 2>&1

Для встановлення оновлень необхідно замінити файли, перевстановити залежності та мігрувати базу даних.

Використовуйте вбудовану команду для імітації Telegram вебхуків.

php artisan telegram:simulate-webhook

Використовуйте префікс для API-ендпоінтів (APP_API_PREFIX), щоб приховати стандартну URL-адресу та обмежити доступ до сайту.

Приклад URL-адреси без префікса:

https://ВАШ.ДОМЕН/api/webhooks/

Приклад URL-адреси з префіксом:

https://ВАШ.ДОМЕН/api/gaok5gee2ooMaegheepholiezeeC0pau/webhooks/

Приклад WAF правила для Cloudflare:

(http.host eq "ВАШ.ДОМЕН" and not starts_with(http.request.uri.path, "/api/gaok5gee2ooMaegheepholiezeeC0pau/webhooks/"))

Офіційний сайт

1) Перейдіть до розділу "Home" і натисніть кнопку "Generar Token", скопіюйте API ключ і натисніть кнопку "Cerrar".

Отримані дані необхідно вказати у файлі змінних оточення.

Приклад заповнення:

MODULE_APISNETPE_RATES_PARSER_ENABLED=true
MODULE_APISNETPE_RATES_PARSER_FETCH_INTERVAL=360
MODULE_APISNETPE_RATES_PARSER_CACHE_TTL=1800
MODULE_APISNETPE_RATES_PARSER_PAIR_PREFIX=ANP
MODULE_APISNETPE_RATES_PARSER_DECIMALS=4
MODULE_APISNETPE_RATES_PARSER_API_KEY=Aevuch4eir3Ap2uShoWoof1Aisie4EiJ

Офіційний сайт

1) Перейдіть до розділу "Profile" - "API for getting exchange rates" і натисніть кнопку "Get", скопіюйте API ключ.

Отримані дані необхідно вказати у файлі змінних оточення.

Приклад заповнення:

MODULE_BESTCHANGE_RATES_PARSER_ENABLED=true
MODULE_BESTCHANGE_RATES_PARSER_FETCH_INTERVAL=1
MODULE_BESTCHANGE_RATES_PARSER_CACHE_TTL=5
MODULE_BESTCHANGE_RATES_PARSER_PAIR_PREFIX=BC
MODULE_BESTCHANGE_RATES_PARSER_DECIMALS=8
MODULE_BESTCHANGE_RATES_PARSER_PAIRS=USDTERC20-P24UAH,ETH-BTC,CASHUSD-USDTTRC20-KIEV
MODULE_BESTCHANGE_RATES_PARSER_ROWS=3
MODULE_BESTCHANGE_RATES_PARSER_SKIP_EXCHANGER_IDS=
MODULE_BESTCHANGE_RATES_PARSER_API_KEY=eileichah2Ahceizaegeemee2amah1Su

Офіційний сайт

1) Перейдіть до розділу "Settings" - "API Key" і скопіюйте "MerchantID" (ID мерчанта).

Отримані дані необхідно вказати у файлі змінних оточення.

Приклад заповнення:

MODULE_BETPAY_RATES_PARSER_ENABLED=true
MODULE_BETPAY_RATES_PARSER_FETCH_INTERVAL=1
MODULE_BETPAY_RATES_PARSER_CACHE_TTL=5
MODULE_BETPAY_RATES_PARSER_PAIR_PREFIX=BTP
MODULE_BETPAY_RATES_PARSER_DECIMALS=4
MODULE_BETPAY_RATES_PARSER_MERCHANT_ID=ruutai7saNgiegah0cinequ8hun4doo4

Офіційний сайт

Приклад заповнення:

MODULE_BINANCEP2P_RATES_PARSER_ENABLED=true
MODULE_BINANCEP2P_RATES_PARSER_FETCH_INTERVAL=5
MODULE_BINANCEP2P_RATES_PARSER_CACHE_TTL=15
MODULE_BINANCEP2P_RATES_PARSER_PAIR_PREFIX=BP2P
MODULE_BINANCEP2P_RATES_PARSER_DECIMALS=4
MODULE_BINANCEP2P_RATES_PARSER_PAIRS=USDT:UAH|PrivatBank,Monobank|BUY,SELL+USDC:USD|Payeer|SELL
MODULE_BINANCEP2P_RATES_PARSER_ROWS=3
MODULE_BINANCEP2P_RATES_PARSER_VERIFIED_MERCHANTS=true
MODULE_BINANCEP2P_RATES_PARSER_PRO_MERCHANTS=false

Офіційний сайт

Приклад заповнення:

MODULE_COINGECKO_RATES_PARSER_ENABLED=true
MODULE_COINGECKO_RATES_PARSER_FETCH_INTERVAL=5
MODULE_COINGECKO_RATES_PARSER_CACHE_TTL=15
MODULE_COINGECKO_RATES_PARSER_PAIR_PREFIX=CGK
MODULE_COINGECKO_RATES_PARSER_DECIMALS=4
MODULE_COINGECKO_RATES_PARSER_BASE_CURRENCY=USD
MODULE_COINGECKO_RATES_PARSER_COINS=ethereum,bitcoin
MODULE_COINGECKO_RATES_PARSER_LIMIT=50
MODULE_COINGECKO_RATES_PARSER_API_KEY=Ohbee8quo5eiroeToka0chach9YaeT0o

Офіційний сайт

1) Перейдіть до розділу "Overview" - "API Key", скопіюйте ключ API натиснувши кнопку "Copy Key".

Отримані дані необхідно вказати у файлі змінних оточення.

Приклад заповнення:

MODULE_COINMARKETCAP_RATES_PARSER_ENABLED=true
MODULE_COINMARKETCAP_RATES_PARSER_FETCH_INTERVAL=5
MODULE_COINMARKETCAP_RATES_PARSER_CACHE_TTL=15
MODULE_COINMARKETCAP_RATES_PARSER_PAIR_PREFIX=CMC
MODULE_COINMARKETCAP_RATES_PARSER_DECIMALS=8
MODULE_COINMARKETCAP_RATES_PARSER_BASE_CURRENCY=USD
MODULE_COINMARKETCAP_RATES_PARSER_COINS=bitcoin,ethereum
MODULE_COINMARKETCAP_RATES_PARSER_LIMIT=50
MODULE_COINMARKETCAP_RATES_PARSER_API_KEY=xubeezi5xohCeesaiqu2daequohchae1

Офіційний сайт

1) Перейдіть до розділу "Dashboard" - "Default Key" і скопіюйте API ключ.

Отримані дані необхідно вказати у файлі змінних оточення.

Приклад заповнення:

MODULE_CURRENCYAPI_RATES_PARSER_ENABLED=true
MODULE_CURRENCYAPI_RATES_PARSER_FETCH_INTERVAL=1440
MODULE_CURRENCYAPI_RATES_PARSER_CACHE_TTL=4320
MODULE_CURRENCYAPI_RATES_PARSER_PAIR_PREFIX=CA
MODULE_CURRENCYAPI_RATES_PARSER_DECIMALS=4
MODULE_CURRENCYAPI_RATES_PARSER_BASE_CURRENCY=USD
MODULE_CURRENCYAPI_RATES_PARSER_CURRENCIES=EUR,UAH
MODULE_CURRENCYAPI_RATES_PARSER_API_KEY=phooR7ing1Ichah5aiRah1Aijeep8AhN

Офіційний сайт

1) Перейдіть до розділу "Settings" - "API Key" і скопіюйте "MerchantID" (ID мерчанта).

2) Натисніть кнопку "Generate new Secret Key" і скопіюйте "Secret Key" (секретний ключ).

Отримані дані необхідно вказати у файлі змінних оточення.

Приклад заповнення:

MODULE_BETPAY_MERCHANT_ENABLED=true
MODULE_BETPAY_MERCHANT_CURRENCIES=CARDUAH,MONOBUAH,P24UAH
MODULE_BETPAY_MERCHANT_MERCHANT_ID=ahni8pheinair2ahL4xeala1Uowam4he
MODULE_BETPAY_MERCHANT_SECRET_KEY=IeC4vec9gie9eemoozahmohrei5much6

Приклад заповнення:

MODULE_TELEGRAM_CHAT_MERCHANT_ENABLED=true
MODULE_TELEGRAM_CHAT_MERCHANT_CURRENCIES=CARDUAH,MONOBUAH,P24UAH
MODULE_TELEGRAM_CHAT_MERCHANT_DEFAULT_LOCALE=ru
MODULE_TELEGRAM_CHAT_MERCHANT_ROUTE_PREFIX=tcm
MODULE_TELEGRAM_CHAT_MERCHANT_OPERATOR_ACCEPT_CHAR=+
MODULE_TELEGRAM_CHAT_MERCHANT_OPERATOR_SKIP_CHAR=-
MODULE_TELEGRAM_CHAT_MERCHANT_PAYMENT_CONFIRMATION=true
MODULE_TELEGRAM_CHAT_MERCHANT_NOTIFY_USER_PAYMENT_DETAILS=false
MODULE_TELEGRAM_CHAT_MERCHANT_API_ENABLED=false
MODULE_TELEGRAM_CHAT_MERCHANT_RECEIPT_UPLOAD=true
MODULE_TELEGRAM_CHAT_MERCHANT_RECEIPT_MIME_TYPES=image/jpg,image/jpeg,image/png,image/heic,application/pdf
MODULE_TELEGRAM_CHAT_MERCHANT_RECEIPT_MAX_SIZE=1000

Для доступу до панелі Адміністратора використовуйте URL-адресу:

https://ВАШ.ДОМЕН/pm/admin/auth

Для додавання Адміністратора використовуйте команду:

php artisan admin:create pool_merchant <email> <пароль>

Для видалення Адміністратора використовуйте команду:

php artisan admin:delete pool_merchant <email>

Приклад заповнення:

MODULE_POOL_MERCHANT_ENABLED=true
MODULE_POOL_MERCHANT_CURRENCIES=CARDUAH,MONOBUAH,P24UAH
MODULE_POOL_MERCHANT_ROUTE_PREFIX=pm
MODULE_POOL_MERCHANT_PAGINATION_LIMIT=25
MODULE_POOL_MERCHANT_THEME=auto
MODULE_POOL_MERCHANT_FALLBACK_MERCHANT=

Офіційний сайт

1) Перейдіть до розділу "Settings" - "Tokens".

2) У вікні, що відкриється, натисніть кнопку "Generate" та скопіюйте "API Token".

3) Перейдіть до розділу "Payment pages" - "General" та скопіюйте "Slug" (ID мерчанта).

Отримані дані необхідно вказати у файлі змінних оточення.

Приклад заповнення:

MODULE_PAYPLAY_MERCHANT_ID=agaihoish3oo5Ael
MODULE_PAYPLAY_MERCHANT_TOKEN=Iciu3shahzuW7iereiTh2olik8Yae1ma

Офіційний сайт

1) Перейдіть до розділу "Settings" - "API Key" і скопіюйте "MerchantID" (ID мерчанта).

Отримані дані необхідно вказати у файлі змінних оточення.

Приклад заповнення:

MODULE_BAD_USERS_CHECKER_ENABLED=true
MODULE_BAD_USERS_CHECKER_ORDER_STATUS=CREATED
MODULE_BAD_USERS_CHECKER_CACHE_TTL=1440
MODULE_BAD_USERS_CHECKER_IP_API_KEY=
MODULE_BAD_USERS_CHECKER_COUNTRIES_DETECTION=IR,KP,CU
MODULE_BAD_USERS_CHECKER_CONTINENTS_DETECTION=
MODULE_BAD_USERS_CHECKER_PROXY_DETECTION=true
MODULE_BAD_USERS_CHECKER_MOBILE_DETECTION=false

Офіційний сайт

Приклад заповнення:

MODULE_BESTCHANGE_SCAM_CHECKER_ENABLED=true
MODULE_BESTCHANGE_SCAM_CHECKER_ORDER_STATUS=CREATED
MODULE_BESTCHANGE_SCAM_CHECKER_ROUTE_PREFIX=bsc
MODULE_BESTCHANGE_SCAM_CHECKER_REPORT_LINK_EXPIRATION=180
MODULE_BESTCHANGE_SCAM_CHECKER_ACCOUNT_ID=123
MODULE_BESTCHANGE_SCAM_CHECKER_API_KEY=ieChiobainga1ol4Feibaesie7Thaife
MODULE_BESTCHANGE_SCAM_CHECKER_USE_LOCAL_DB=false
MODULE_BESTCHANGE_SCAM_CHECKER_VALUE_MIN_LENGTH=8
MODULE_BESTCHANGE_SCAM_CHECKER_IP_DETECTION=true
MODULE_BESTCHANGE_SCAM_CHECKER_EMAIL_DETECTION=true
MODULE_BESTCHANGE_SCAM_CHECKER_PHONE_DETECTION=true
MODULE_BESTCHANGE_SCAM_CHECKER_NAME_DETECTION=true
MODULE_BESTCHANGE_SCAM_CHECKER_PAYMENT_DETAILS_DETECTION=true
MODULE_BESTCHANGE_SCAM_CHECKER_COMMAND_CHECK=bestchangescamcheck
MODULE_BESTCHANGE_SCAM_CHECKER_THEME=auto

Приклад заповнення:

MODULE_EXCHANGER_MANAGER_ENABLED=true

Приклад заповнення:

MODULE_USERS_MANAGER_ENABLED=true

Приклад заповнення:

MODULE_ORDERS_MANAGER_ENABLED=true

Приклад заповнення:

MODULE_CURRENCIES_MANAGER_ENABLED=true
MODULE_CURRENCIES_MANAGER_GROUPS=G1:331,333|G2:327

Приклад заповнення:

MODULE_DIRECTIONS_MANAGER_ENABLED=true
MODULE_DIRECTIONS_MANAGER_GROUPS=G1:100,101|G2:105