The add-ons is built on the Laravel framework. Detailed information on installation and configuration can be found on the official website.

Laravel

1) Register a new bot using "@botFather" and copy its token (secret key).

2) Using "@userinfobot", find out and copy your "ID" (user identifier).

Dashboard API

1) Generate a secret key in the "Application Settings" - "Dashboard API Settings" section.

2) Fill in the list of trusted IP addresses.

Private API

1) Generate a secret key in the "Application Settings" - "Private API Settings" section.

2) Enable all methods.

3) Fill in the list of trusted IP addresses.

Webhooks

1) Generate a secret key in the "Application Settings" - "Webhook Settings" section.

2) Enable all events.

3) Fill the host input.

https://YOUR.DOMAIN/api/webhooks/exchanger

Custom Merchant

1) Generate a secret key in the "Application Settings" - "Custom Merchant Settings" section.

2) Fill the host input.

https://YOUR.DOMAIN/api/merchants/form

Custom Rates Parser

1) Generate a secret key in the "Application Settings" - "Custom Rates Parser Settings" section.

2) Fill the host input.

https://YOUR.DOMAIN/api/rates

Before starting installation, create a text file and fill in the environment variables with your data. You also need to add the environment variables of the purchased add-ons to the file.

Example configuration:

APP_URL=https://YOUR.DOMAIN
APP_API_PREFIX=
APP_TIMEZONE=Europe/Kyiv
APP_LOCALE=en
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

Use the environment variables below for more advanced configuration.

Default values:

HTTP_CONNECT_TIMEOUT=3
HTTP_TIMEOUT=9

TELEGRAM_MAX_CONNECTIONS=1
TELEGRAM_SENDING_DELAY=500000
TELEGRAM_ERROR_REPORTING=true

EXCHANGER_USER_AGENT=EXCMSMA

1) Purchase the Telegram Bot.

2) Download the archive with files and extract it into the root directory of your site.

3) Create a ".env" file (environment variables file) and fill it with the prepared data.

4) Install dependencies.

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

5) Generate the application key.

php artisan key:generate

6) Run the database migration.

php artisan migrate

7) Set up the Telegram webhook.

php artisan telegram:setup-webhook

8) Optimize the application.

php artisan optimize

9) Set up the task scheduler (CRON) for user "www-data" to run the command every minute:

* * * * * /usr/bin/php /var/www/YOUR.DOMAIN/artisan schedule:run >> /dev/null 2>&1

To install updates, replace the files, reinstall dependencies, and migrate the database.

Use the built-in command to simulate Telegram webhooks.

php artisan telegram:simulate-webhook

Use a prefix for API endpoints (APP_API_PREFIX) to hide the standard URL and restrict access to the site.

Example URL without prefix:

https://YOUR.DOMAIN/api/webhooks/

Example URL with prefix:

https://YOUR.DOMAIN/api/gaok5gee2ooMaegheepholiezeeC0pau/webhooks/

Example WAF rule for Cloudflare:

(http.host eq "YOUR.DOMAIN" and not starts_with(http.request.uri.path, "/api/gaok5gee2ooMaegheepholiezeeC0pau/webhooks/"))

Official Website

1) Go to the "Home" section and click the "Generar Token" button, copy the API key, and click the "Cerrar" button.

The obtained data must be specified in the environment variables file.

Example configuration:

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

Official Website

1) Go to the "Profile" - "API for getting exchange rates" section and click the "Get" button, copy the API key.

The obtained data must be specified in the environment variables file.

Example configuration:

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

Official Website

1) Go to the "Settings" - "API Key" section and copy the "MerchantID" (merchant ID).

The obtained data must be specified in the environment variables file.

Example configuration:

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

Official Website

Example configuration:

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

Official Website

Example configuration:

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

Official Website

1) Go to the "Overview" - "API Key" section and copy the API key by clicking the "Copy Key" button.

The obtained data must be specified in the environment variables file.

Example configuration:

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

Official Website

1) Go to the "Dashboard" - "Default Key" section and copy the API key.

The obtained data must be specified in the environment variables file.

Example configuration:

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

Official Website

1) Go to the "Settings" - "API Key" section and copy the "MerchantID" (merchant ID).

2) Click the "Generate new Secret Key" button and copy the "Secret Key".

The obtained data must be specified in the environment variables file.

Example configuration:

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

Example configuration:

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

To access the Admin panel, use the following URL:

https://YOUR.DOMAIN/pm/admin/auth

To add an Administrator, use the command:

php artisan admin:create pool_merchant <email> <password>

To delete an Administrator, use the command:

php artisan admin:delete pool_merchant <email>

Example configuration:

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=

Official Website

1) Go to the "Settings" - "Tokens" section.

2) In the window that opens, click the "Generate" button and copy the "API Token".

3) Go to the "Payment pages" - "General" section and copy the "Slug" (merchant ID).

The obtained data must be specified in the environment variables file.

Example configuration:

MODULE_PAYPLAY_MERCHANT_ID=agaihoish3oo5Ael
MODULE_PAYPLAY_MERCHANT_TOKEN=Iciu3shahzuW7iereiTh2olik8Yae1ma

Official Website

1) Go to the "Settings" - "API Key" section and copy the "MerchantID" (merchant ID).

The obtained data must be specified in the environment variables file.

Example configuration:

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

Official Website

Example configuration:

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

Example configuration:

MODULE_EXCHANGER_MANAGER_ENABLED=true

Example configuration:

MODULE_USERS_MANAGER_ENABLED=true

Example configuration:

MODULE_ORDERS_MANAGER_ENABLED=true

Example configuration:

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

Example configuration:

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