Налаштування акаунту
У налаштуваннях акаунту ви можете керувати вашою особистою інформацією та налаштуваннями:
Доступні налаштування
- Оновити ім'я та контактний номер телефону
- Вибрати країну та оновити реквізити для цієї країни
- Змінити мову інтерфейсу
- Змінити пароль (для акаунтів з реєстрацією через email)
- Видалити акаунт назавжди
Профіль користувача
Базова інформація про користувача, що зберігається в таблиці users. Ці дані універсальні для всіх країн.
| Поле | Тип | Опис |
|---|---|---|
name | string(255) | Повне ім'я |
email | string(180) | Email адреса (унікальна, використовується для входу) |
phone | string(20) | Номер телефону в міжнародному форматі (E.164) |
country | relation | Країна користувача (визначає форму реквізитів) |
currency | relation | Валюта для відображення цін |
locale | string(5) | Мова інтерфейсу (en, uk, ru, pl) |
notify_by_telegram | boolean | Отримувати сповіщення в Telegram (за замовчуванням увімкнено) |
notify_by_email | boolean | Отримувати сповіщення на Email (за замовчуванням увімкнено) |
API профілю
GET /api/v1/user/profile # Get current user profile PUT /api/v1/user/profile # Update profile
Приклад відповіді
{
"id": 1,
"name": "John Smith",
"email": "[email protected]",
"phone": "+48501234567",
"locale": "en",
"country": {
"code": "PL",
"name": {"en": "Poland", "uk": "Польща"},
"phone_code": "+48"
},
"currency": {
"code": "EUR",
"symbol": "€",
"name": {"en": "Euro"}
},
"roles": ["ROLE_USER"],
"is_active": true,
"notify_by_telegram": true,
"notify_by_email": true,
"created_at": "2026-01-10T09:00:00+00:00",
"updated_at": "2026-01-10T09:00:00+00:00"
}
Реквізити по країнах
Система підтримує різні реквізити для різних країн. Якщо ви обираєте країну, для якої доступні специфічні реквізити, з'явиться додатковий розділ для їх заповнення.
Архітектура:
Реквізити зберігаються в окремих таблицях для кожної країни. Коли ви обираєте країну в налаштуваннях, з'являється відповідна форма реквізитів. Реквізити повністю відокремлені від даних профілю користувача.
Україна (UA)
Україна — ІПН, банківські реквізити (IBAN/картка), дані ФОП
| Поле | Тип | Опис |
|---|---|---|
tax_id | string(10) | ІПН — 8 цифр для юридичних осіб, 10 для фізичних |
passport | text | Паспортні дані (серія, номер, ким виданий) |
iban | string(34) | IBAN рахунок (формат залежить від країни) |
card_number | string(19) | Номер банківської картки (16 цифр) |
card_holder_name | string(100) | Ім'я власника картки (як на картці, латиницею) |
preferred_payment_method | enum | Бажаний спосіб оплати: iban / card |
is_fop | boolean | Чи є ФОП — важливо для договорів |
fop_registry_number | string(30) | Номер запису в реєстрі підприємців |
fop_registration_date | date | Дата реєстрації підприємця |
fop_group | smallint | Група оподаткування (1, 2 або 3) |
address | text | Адреса реєстрації |
API реквізитів
# Country-specific requisites endpoints (separate from profile) GET /api/v1/user/requisites/ukraine # Get requisites for Ukraine PUT /api/v1/user/requisites/ukraine # Update requisites for Ukraine
Приклад відповіді
{
"id": 1,
"tax_id": "1234567890",
"passport": "AB 123456, issued by...",
"iban": "UA213223130000026007233566001",
"card_number": "**** **** **** 1234",
"card_holder_name": "JOHN SMITH",
"preferred_payment_method": "iban",
"is_fop": true,
"fop_registry_number": "20000000000000000000",
"fop_registration_date": "2020-01-15",
"fop_group": 3,
"address": "123 Main Street, City",
"created_at": "2026-01-10T09:00:00+00:00",
"updated_at": "2026-01-10T09:00:00+00:00"
}
Swagger / OpenAPI:
Повна документація API з прикладами запитів та відповідей:
/api/v1/doc
Інші країни
Система підтримує додавання реквізитів для інших країн. Кожна країна має свою таблицю та API ендпоінти. Наразі підтримуються:
- UA — Україна: ІПН, банківські реквізити, дані ФОП
Інші країни будуть додані за запитами користувачів.
Видалення акаунту
Ви можете назавжди видалити свій акаунт на сторінці налаштувань. Для безпеки на вашу пошту буде надіслано код підтвердження. Ця дія незворотна.