Integrations
A catalog of the platform's external providers (FX, VIN, container trackers, payments, storage, mail, maps) with environment variables.
The platform connects external services through providers. Each has a full implementation, the key is taken from an environment variable, and without a key a mock provider runs and Desk shows a "demo mode" badge. There are no real calls in that mode.
The table is generated from code
It is taken from describeProviders (@core/integrations) at build time. This shows the catalog, not your
server's state: what is active for you is visible in Desk under Settings → Integrations (key values are
never shown).
| Integration | Environment variables | Provider docs | Note |
|---|---|---|---|
Курси валют (НБУ + ЄЦБ) (fx) | no key needed | bank.gov.ua | Публічні API без ключа. Курси UAH — офіційні курси НБУ, не комерційні. |
Декодер VIN (NHTSA vPIC) (vin) | no key needed | 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 | — |
Modes
| Mode | Meaning |
|---|---|
live | a real provider with a working key |
test | the provider's sandbox (for example LIQPAY_SANDBOX=true or a test_… merchant in WayForPay) |
mock (demo) | no key: test data, no real actions |
Where to set variables
Variables are set on the server (the .env file, GitHub Actions secrets at runtime), not passed as Docker build arguments and not placed in code. The full list with comments is in the integrations section of the repository's .env.example.
Payment providers depend on the tenant: ImportOS subscriptions are handled by Stripe, while client deposits go through LiqPay, WayForPay or monobank. Electronic signature (Vchasno, Diia.Pidpys) is Waiting on the owner: the interface exists, there are no real clients yet.