Account Settings
In your account settings, you can manage your personal information and preferences:
Available Settings
- Update name and contact phone number
- Select your country and update country-specific requisites
- Change preferred interface language
- Change password (for email-registered accounts)
- Delete account permanently
User Profile
Basic user information stored in the users table. This data is universal for all countries.
| Field | Type | Description |
|---|---|---|
name | string(255) | Full name |
email | string(180) | Email address (unique, used for login) |
phone | string(20) | Phone number in international format (E.164) |
country | relation | User country (determines requisites form) |
currency | relation | Preferred currency for displaying prices |
locale | string(5) | Interface language (en, uk, ru, pl) |
notify_by_telegram | boolean | Receive Telegram notifications (enabled by default) |
notify_by_email | boolean | Receive Email notifications (enabled by default) |
Profile API
GET /api/v1/user/profile # Get current user profile PUT /api/v1/user/profile # Update profile
Example Response
{
"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"
}
Country-Specific Requisites
The system supports different requisites for different countries. If you select a country that has specific requisites available, an additional section will appear for you to fill in.
Architecture:
Requisites are stored in separate tables for each country. When you select a country in settings, the corresponding requisites form appears. Requisites are completely separate from user profile data.
Ukraine (UA)
Ukraine — Tax ID, bank details (IBAN/card), FOP (sole proprietor) data
| Field | Type | Description |
|---|---|---|
tax_id | string(10) | Tax ID - 8 digits for legal entities, 10 for individuals |
passport | text | Passport data (series, number, issued by) |
iban | string(34) | IBAN account (country-specific format) |
card_number | string(19) | Bank card number (16 digits) |
card_holder_name | string(100) | Card holder name (as on card, Latin letters) |
preferred_payment_method | enum | Preferred payment method: iban / card |
is_fop | boolean | Is sole proprietor - important for contracts |
fop_registry_number | string(30) | Business registry number |
fop_registration_date | date | Business registration date |
fop_group | smallint | Tax group (1, 2, or 3) |
address | text | Registration address |
Requisites 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
Example Response
{
"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:
Full API documentation with request/response examples:
/api/v1/doc
Other Countries
The system supports adding requisites for other countries. Each country has its own table and API endpoints. Currently supported:
- UA — Ukraine: Tax ID, bank details, sole proprietor data
More countries will be added based on user demand.
Account Deletion
You can permanently delete your account from the settings page. A confirmation code will be sent to your email for security. This action is irreversible.