Інтеграції
Каталог зовнішніх провайдерів платформи (курси, VIN, трекери контейнерів, платіжки, сховище, пошта, карти) зі змінними середовища.
Платформа підключає зовнішні сервіси через провайдери. Для кожного є повна реалізація, ключ береться зі змінної середовища, а без ключа працює mock-провайдер, і Desk показує бейдж «демо-режим». Реальних викликів у такому режимі немає.
Таблиця генерується з коду
Вона береться з describeProviders (@core/integrations) під час збірки. Тут показано каталог, а не стан
вашого сервера: що активне саме у вас, видно в Desk: Налаштування → Інтеграції (значення ключів не
показуються ніколи).
| Інтеграція | Змінні середовища | Документація провайдера | Примітка |
|---|---|---|---|
Курси валют (НБУ + ЄЦБ) (fx) | ключ не потрібен | bank.gov.ua | Публічні API без ключа. Курси UAH — офіційні курси НБУ, не комерційні. |
Декодер VIN (NHTSA vPIC) (vin) | ключ не потрібен | vpic.nhtsa.dot.gov | Безкоштовно, без ключа. Повні дані лише для авто, проданих у США. |
Відстеження контейнерів (containers) | TERMINAL49_API_KEYSHIPSGO_API_KEY | terminal49.com | Достатньо одного з ключів. Вебхуки: TERMINAL49_WEBHOOK_SECRET / SHIPSGO_WEBHOOK_SECRET. |
LiqPay (payments.liqpay) | LIQPAY_PUBLIC_KEYLIQPAY_PRIVATE_KEY | www.liqpay.ua | LIQPAY_SANDBOX=true — тестовий режим. |
WayForPay (payments.wayforpay) | WAYFORPAY_MERCHANTWAYFORPAY_SECRETWAYFORPAY_DOMAIN | wiki.wayforpay.com | Мерчант з префіксом test_ вважається тестовим. |
monobank acquiring (payments.monobank) | MONOBANK_TOKEN | api.monobank.ua | MONOBANK_TEST=true для токена з api.monobank.ua (тестове середовище). |
Stripe (разові платежі) (payments.stripe) | STRIPE_SECRET_KEYSTRIPE_WEBHOOK_SECRET | docs.stripe.com | — |
Stripe Billing (підписки ImportOS) (billing.stripe) | STRIPE_SECRET_KEYSTRIPE_WEBHOOK_SECRETSTRIPE_PRICE_STARTERSTRIPE_PRICE_PROSTRIPE_PRICE_BUSINESS | docs.stripe.com | Для Customer Portal налаштуйте Portal у дашборді Stripe; для Stripe Tax — STRIPE_TAX_ENABLED=true. |
Файлове сховище (S3) (storage) | S3_ENDPOINTS3_ACCESS_KEY_IDS3_SECRET_ACCESS_KEY | rustfs.com | У dev — RustFS (127.0.0.1:41900). Без S3 файли живуть у пам’яті процесу й зникають при перезапуску. |
Нова пошта API 2.0 (novaposhta) | NOVAPOSHTA_API_KEY | developers.novaposhta.ua | — |
Google Places (рейтинг і відгуки) (places) | GOOGLE_PLACES_API_KEYGOOGLE_PLACE_ID | developers.google.com | — |
Режими
| Режим | Значення |
|---|---|
live | реальний провайдер із робочим ключем |
test | пісочниця провайдера (наприклад LIQPAY_SANDBOX=true або мерчант test_… у WayForPay) |
mock (демо) | немає ключа: тестові дані, без реальних дій |
Де задавати змінні
Змінні задаються на сервері (файл .env, GitHub Actions secrets в runtime), а не передаються як build-аргументи Docker і не потрапляють у код. Повний перелік і коментарі до них: секція інтеграцій у .env.example репозиторію.
Платіжні провайдери залежно від тенанта: підписки ImportOS обробляє Stripe, а депозити клієнтів — LiqPay, WayForPay або monobank. Електронний підпис (Вчасно, Дія.Підпис) Чекає на власника: інтерфейс є, реальних клієнтів поки немає.