Настройка комиссий для валют в QryptoPay
QryptoPay умеет добавлять к сумме заказа отдельную комиссию за оплату каждой криптовалютой — процент от суммы с необязательными нижним и верхним порогом. Настройка одна на весь модуль: включили общий переключатель и задали процент по нужным валютам — и комиссия начинает применяться к новым платежам.
ℹ️ Почему это нужно
Деньги покупателя не всегда сразу оказываются у вас на конечном кошельке — в некоторых сетях, чтобы собрать поступившие средства, нужно заплатить комиссию сети. Дополнительная комиссия за оплату помогает компенсировать эти расходы. А ещё это способ направлять денежный поток в валюты, которые вам интересны, не отключая остальные полностью.
Три способа распределить этот расход
Как компенсировать расход на перевод — решаете вы, и вариантов три:
- За свой счёт. Цена в магазине не меняется, а расход на перевод каждый раз списывается с вашего кошелька. Он не постоянный — зависит от того, какую валюту выбрал покупатель.
- Заложить в цену магазина. Вы сами поднимаете цену товара на среднюю оценку расхода. Это единый подход для всех валют: магазин передаёт QryptoPay итоговую сумму платежа, а конкретную валюту покупатель выбирает уже на этапе оплаты. Просто и предсказуемо, но реальный расход на перевод в разных валютах отличается, а цена — нет.
- Переложить расчёт на QryptoPay — вариант из этой статьи. Только здесь можно задать разную комиссию для разных валют и тем самым скорректировать денежный поток: назначить более высокую комиссию невыгодным вам валютам, а низкую или нулевую — выгодным. Комиссия добавляется к сумме на последнем шаге оплаты и видна покупателю только там, а не в цене товара.
Первые два варианта QryptoPay не отличает — с его стороны это просто «комиссия выключена». Разница только в том, как вы формируете цену у себя в магазине.
Как считается комиссия
Комиссия — процент от суммы заказа. Но для небольших платежей одного процента может не хватить, чтобы гарантированно покрыть расход сети, — для этого предусмотрен нижний порог: минимальный размер комиссии в USD. Для крупных платежей действует обратная логика: верхний порог ограничивает комиссию сверху, чтобы покупка оставалась выгодной для покупателя. Учтите: в некоторых сетях комиссия за перевод статична и не зависит от суммы перевода. Любой из порогов можно не задавать вообще, тогда ограничения с этой стороны нет.
💡 Будьте внимательны с порогами
Слишком высокий или низкий порог может смутить покупателя в момент оплаты. Например, при заказе на 10 USD, комиссии 2 % и нижнем пороге 5 USD итоговая комиссия — 5 USD, а не 0,20 USD: сработал порог. Прежде чем задавать пороги, прикиньте их значение на типичной для вас сумме заказа. Или выставьте на уровне магазина минимальную сумму к оплате криптовалютой.
ℹ️ Комиссия — для валюты, не для сети и не для мерчанта
USDT в сети Ethereum и USDT в сети Tron получают одинаковую комиссию — отдельно настроить их нельзя. Настройка при этом общая для всего модуля: если у вас несколько мерчантов, комиссия действует одинаково для всех, раздельных настроек по мерчантам нет.
Комиссия фиксируется один раз — в момент, когда покупателю выставляется счёт. Если вы поменяете процент или пороги позже, уже выставленные счета это не затронет — новые значения применятся только к следующим платежам.
Что видит покупатель
Сумма к оплате на платёжной странице уже включает комиссию — отдельно её добавлять не нужно. Размер комиссии подписан у каждого способа оплаты и рядом с суммой заказа, так что покупатель может сам сравнить валюты и выбрать ту, где комиссия меньше.
Что получает магазин
В уведомлении о платеже комиссия видна отдельно от суммы заказа, поэтому вы всегда знаете, сколько пришло от покупателя, сколько из этого удержано и сколько осталось вам.
⚠️ Пересмотрите сверку платежей
Если ваша интеграция сравнивает сумму платежа с суммой заказа, включение комиссии эту сверку изменит: сумма платежа станет больше суммы заказа на размер комиссии. Сверяйтесь по новым полям уведомления, а не только по исходной сумме.
Как настроить магазин
Чтобы магазин корректно обрабатывал комиссии, сверять заказ нужно с той суммой, которая досталась магазину, а не с полной суммой, пришедшей от покупателя. Ниже выдержка из уведомления о платеже — только те поля, которые для этого нужны (заказ на 49 USD, комиссия 5 USD):
{
"payment_result": "success", // результат платежа
"amount_fiat": "54.00", // пришло от покупателя всего: заказ и комиссия
"surcharge_fiat": "5.00", // удержанная комиссия
"amount_fiat_net": "49.00" // осталось магазину — сверяйте заказ с этой суммой
}Первое число всегда равно сумме двух последних: amount_fiat = amount_fiat_net + surcharge_fiat.
Оба поля с комиссией приходят всегда, даже когда комиссия выключена: тогда surcharge_fiat равен 0.00, а amount_fiat_net совпадает с amount_fiat. Поэтому уже написанные интеграции не ломаются, а перейти на новые поля можно заранее — до того, как вы включите комиссию.
Это только выдержка: полный состав уведомления и порядок его проверки описаны в Руководстве по настройке QryptoPay.
Автоматически проводите только успешные платежи
В уведомлении есть метка результата: платёж прошёл штатно, пришла не та сумма или платёж вообще без выставленного счёта (подробнее о каждом случае — в статье Руководство по настройке QryptoPay). На комиссию это тоже влияет: рассчитать её точно можно только для штатного платежа, а два других случая безопаснее разбирать руками — доплата, возврат или решение оставить как есть.
Bitcoin и Litecoin — расход возникает иначе
Для Bitcoin и Litecoin сам приём платежа ничего не стоит — деньги сразу оказываются у вас, отдельного перевода с адреса покупателя нет. Расход появляется позже, при выводе накопленных денег: сеть объединяет полученные ранее платежи в одну транзакцию, и стоимость этой транзакции растёт с количеством объединяемых платежей, а не с их суммой.
Поэтому расход на вывод в этих валютах зависит от того, сколько платежей вы приняли, а не на какие суммы. Включённая комиссия за оплату Bitcoin или Litecoin не отражает этот расход напрямую — как и в любой другой валюте, это ваше собственное решение, а не пересчёт реальных расходов.
Как включить
Комиссии настраиваются в разделе QryptoPay → «Настройки» → «Валюты», в блоке «Комиссии»: общий переключатель включает или выключает комиссию для всего модуля, а клик по валюте открывает процент и оба порога для неё отдельно.
💡 По умолчанию комиссии нет
Пока вы явно не зададите процент, комиссия для валюты равна нулю — включение общего переключателя само по себе ничего не меняет в стоимости платежей.