← Вернуться в блог

Мультивалютная поддержка: принимайте платежи в 50+ фиатных валютах

· 2 min read
функция валюты анонс

MutoPay теперь поддерживает более 50 фиатных валют. Мерчанты могут создавать платежи, номинированные в EUR, GBP, SAR, AED, JPY, AMD и многих других. Сумма конвертируется в USD по текущему обменному курсу при создании платежа, и клиент платит эквивалент в криптовалюте.

Как это работает

При создании платежа вы указываете сумму и валюту:

curl -X POST https://mutopay.com/api/payments \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"amount": 100, "currency": "EUR"}'

MutoPay конвертирует сумму в USD, используя курсы в реальном времени из центральных банков через Frankfurter API. Ответ включает как оригинальную сумму, так и конвертированное значение в USD:

{
  "amount_usd": 108.42,
  "amount_original": 100.00,
  "currency": "EUR",
  "fx_rate": 1.0842
}

Обменный курс фиксируется при создании и сохраняется с платежом для полной проверяемости.

Поддерживаемые валюты

Доступно более 50 валют, включая:

  • Америка: USD, CAD, BRL, MXN, ARS, CLP, COP, PEN
  • Европа: EUR, GBP, CHF, SEK, NOK, DKK, PLN, CZK, HUF, RON, ISK, UAH, RUB
  • Ближний Восток: SAR, AED, KWD, BHD, QAR, OMR, JOD, IQD, TRY, ILS
  • Азиатско-Тихоокеанский регион: JPY, INR, CNY, SGD, HKD, KRW, TWD, THB, MYR, PHP, IDR, VND, PKR
  • Африка: EGP, ZAR, NGN, KES, MAD, TND
  • Кавказ: AMD, GEL

Любая валюта, поддерживаемая Frankfurter API, будет работать, даже если её нет в выпадающем списке.

Где это работает

Мультивалютность доступна везде, где вы создаёте платежи:

  • Панель управления — выбирайте валюту из выпадающего списка при создании платёжной ссылки
  • REST API — передавайте "currency": "EUR" (или любой код) вместе с "amount"
  • WooCommerce — валюта вашего магазина отправляется автоматически. Магазин в EUR создаёт EUR-платежи, магазин в SAR — SAR-платежи

Для WooCommerce-мерчантов

Если ваш WooCommerce-магазин настроен на не-USD валюту, плагин MutoPay теперь автоматически отправляет валюту вашего магазина. Никакой настройки не нужно — всё просто работает. Итоговая сумма заказа в вашей местной валюте конвертируется в USD на сервере, и клиент видит эквивалентную сумму на странице оплаты.

Обменные курсы

Курсы берутся из Frankfurter API, который агрегирует данные 30+ центральных банков, включая Европейский центральный банк, Банк Японии и другие. Курсы кэшируются на 2 часа для производительности, с 24-часовым устаревшим запасом при временной недоступности upstream.

Обратная совместимость

Существующее поле amount_usd по-прежнему работает. Если вы уже интегрированы и отправляете суммы в USD, ничего не меняется. Новые поля amount + currency аддитивны — используйте их, когда будете готовы.

Посетите вашу панель управления MutoPay, чтобы попробовать.