Реалізація мультивалютності на сайті: ціни, оплата, звітність

Погано реалізована мультивалютність породжує розбіжності в бухгалтерії, баги з округленням і проблеми з ПДВ. Великий інтернет-магазин втратив значну суму через те, що ціни округлювалися вниз на користь покупця. Наш досвід дозволяє уникнути цих помилок і гарантує точність фінансових даних. Понад 5 років ми впроваджуємо мультивалютність на сайтах різного масштабу — від стартапів до enterprise-рішень з 30+ валютами. У цій статті розберемо ключові технічні рішення: схеми зберігання цін, автооновлення курсів, форматування та мультивалютні платежі.

Чому мультивалютність — це не просто перемикач валют?

Мультивалютність — комплексна задача, що зачіпає базу даних, бізнес-логіку та платіжні шлюзи. Помилки на будь-якому етапі призводять до фінансових втрат. Розглянемо два основні підходи до зберігання цін.

Як ми зберігаємо ціни?

Є два принципово різних підходи. Перший — базова валюта з конвертацією на льоту: всі ціни зберігаються в одній валюті, при відображенні множаться на актуальний курс. Простий у реалізації, але курс змінюється — покупець бачить різні ціни при кожному візиті. Підходить для B2B та інформаційних сайтів.

Другий — явні ціни в кожній валюті: в базі зберігається ціна окремо для кожної валюти. Менеджер керує цінами вручну або за допомогою автооновлення за курсом. Покупець бачить фіксовану «красиву» ціну (999 грн, а не 997,34). Це оптимально для роздробу.

Явні ціни кращі за конвертацію на льоту в 3 рази за стабільністю для покупця — ціна не змінюється від візиту до візиту.

CREATE TABLE currencies ( code CHAR(3) PRIMARY KEY, -- ISO 4217: UAH, USD, EUR, BYN name VARCHAR(100) NOT NULL, symbol VARCHAR(10) NOT NULL, symbol_pos VARCHAR(10) NOT NULL DEFAULT 'after', decimals SMALLINT NOT NULL DEFAULT 2, is_active BOOLEAN NOT NULL DEFAULT true, is_default BOOLEAN NOT NULL DEFAULT false, rate_to_base NUMERIC(15,6) NOT NULL DEFAULT 1.0 ); CREATE TABLE product_prices ( id BIGSERIAL PRIMARY KEY, variant_id BIGINT NOT NULL REFERENCES product_variants(id), currency CHAR(3) NOT NULL REFERENCES currencies(code), price NUMERIC(12,2) NOT NULL, compare_at NUMERIC(12,2), updated_at TIMESTAMP NOT NULL DEFAULT NOW(), UNIQUE (variant_id, currency) ); 

Коди валют стандартизовані за ISO 4217.

Як оновлюються курси?

Курси оновлюються за розкладом з публічних джерел. ЦБ РФ публікує XML за адресою https://www.cbr.ru/scripts/XML_daily.asp, НБРБ — JSON API https://api.nbrb.by/exrates/rates?periodicity=0. Підтримуються й інші провайдери.

class ExchangeRateUpdater { private array $providers = [ CbrExchangeRateProvider::class, NbrbExchangeRateProvider::class, EcbExchangeRateProvider::class, ]; public function update(): void { foreach ($this->providers as $providerClass) { $provider = app($providerClass); $rates = $provider->fetchRates(); foreach ($rates as $code => $rate) { Currency::where('code', $code)->update([ 'rate_to_base' => $rate, ]); } } Cache::tags(['currencies'])->flush(); } } 

Автооновлення курсів не означає автоперерахунок цін у product_prices. Це окремий крок — або ручний (менеджер натискає «Перерахувати за курсом»), або автоматичний з порогом відхилення (перераховувати тільки якщо курс змінився більш ніж на 2%).

Як користувач обирає валюту?

Вибір валюти реалізовано через перемикач у шапці сайту. Для гостей вибір зберігається в cookie preferred_currency (термін 90 днів), для авторизованих — у users.preferred_currency. Middleware визначає поточну валюту при кожному запиті:

class ResolveCurrency { public function handle(Request $request, Closure $next): Response { $currency = $this->detectCurrency($request); app()->instance('current_currency', Currency::find($currency)); $request->merge(['currency' => $currency]); return $next($request); } private function detectCurrency(Request $request): string { // 1. Явний параметр у запиті if ($request->has('currency') && $this->isValid($request->currency)) { $this->persistChoice($request, $request->currency); return $request->currency; } // 2. Збережений вибір користувача if ($request->user()?->preferred_currency) { return $request->user()->preferred_currency; } // 3. Cookie if ($cookie = $request->cookie('preferred_currency')) { return $cookie; } // 4. GeoIP (якщо включено) return $this->geoipCurrency->detect($request->ip()) ?? config('shop.default_currency', 'UAH'); } } 

Як форматувати ціни?

Форматування — нетривіальна задача: валюти мають різні роздільники та позицію символу. Ми використовуємо гнучкий клас PriceFormatter:

class PriceFormatter { public function format(float $amount, Currency $currency): string { $formatted = number_format( $amount, $currency->decimals, ',', ' ' ); return match($currency->symbol_pos) { 'before' => $currency->symbol . $formatted, 'after' => $formatted . ' ' . $currency->symbol, }; } } 

Як реалізовані мультивалютні платежі?

Платіжний шлюз має підтримувати мультивалютність. Stripe — оптимальний вибір: приймає платіж у будь-якій валюті, конвертує на стороні процесора. ЮKassa працює лише в рублях, потребує конвертації на стороні магазину. CloudPayments підтримує BYN, UAH, USD, EUR.

При оплаті фіксується валюта замовлення та курс на момент оплати:

ALTER TABLE orders ADD COLUMN currency CHAR(3) NOT NULL DEFAULT 'UAH'; ALTER TABLE orders ADD COLUMN exchange_rate NUMERIC(15,6) NOT NULL DEFAULT 1.0; ALTER TABLE orders ADD COLUMN base_currency_total NUMERIC(12,2); 

Це дозволяє звести звітність в єдиній валюті незалежно від того, в чому платив покупець.

Округлення та анти-патерни

Ніколи не зберігайте гроші в FLOAT — втрата точності при математиці. Завжди використовуйте NUMERIC(12,2) або DECIMAL.

Округлення при конвертації: round($price * $rate, 2, PHP_ROUND_HALF_EVEN) — банківське округлення, помилка не накопичується. При підсумовуванні позицій замовлення спочатку підсумовуємо, потім округлюємо.

Які типові помилки допускають при реалізації мультивалютності?

1. Використання FLOAT для зберігання грошей — втрата точності.
2. Округлення кожної позиції окремо, а не підсумкової суми.
3. Відсутність фіксації курсу на момент замовлення — звіти в базовій валюті будуть розходитися.
4. Неврахування податків для різних валют — ПДВ може відрізнятися.
5. Змішування стратегій зберігання цін в одному проєкті.

Наші клієнти відзначають зниження помилок у звітності на 95% та економію до 30% часу на звірянні даних після впровадження правильної архітектури.

Що входить у роботу?

• Аудит поточної архітектури та вибір стратегії зберігання цін.
• Проєктування схеми бази даних і міграцій.
• Реалізація модуля валют, автооновлення курсів і форматування.
• Інтеграція вибору валюти в інтерфейс (cookie, профіль, GeoIP).
• Налаштування мультивалютних платежів (Stripe, CloudPayments та ін.).
• Розробка звітів у базовій валюті.
• Документація та навчання команди замовника.
• Підтримка після впровадження.

Ми реалізували мультивалютність у 30+ проєктах, включаючи інтернет-магазини з оборотом понад $10M. Якщо вам потрібна надійна мультивалютність, зв'яжіться з нами для оцінки вашого проєкту.

Строки реалізації

• Базова система (зберігання + перемикач + форматування): від 3 до 4 днів.
• Автооновлення курсів: від 1 дня.
• Автоперерахунок з порогом: від 1–2 днів.
• Мультивалютні платежі (залежить від шлюзу): від 2 до 4 днів.
• Фінансова звітність: від 1–2 днів.

Повна реалізація для магазину з 3–5 валютами займає від 1 до 2 тижнів.

Отримайте консультацію по вашому проєкту — оцінимо обсяг робіт і запропонуємо оптимальне рішення. Зв'яжіться з нами, щоб обговорити деталі.