Комиссия в сумме платежа

Настройка проекта

В Настройки → Проект → Комиссия платежа владелец проекта может включить комиссию BramaPay в платёж покупателя. По умолчанию галочка выключена, отдельно для Live и Test. API-ключ не может менять её. Настройка в магазине не требуется.

Она действует только при создании нового счёта или сессии. Версия политики, недельная ставка, суммы и срок фиксируются при выпуске. Старые счета, повторные запросы и новые маршруты внутри уже созданной сессии сохраняют прежние условия. Исторические комиссии не пересчитываются.

Для заказа на $20 при ставке 1% база платежа составляет 20.202021, до отдельной уникальной дробной части маршрута. Комиссия считается с повышенной суммы, поэтому простого прибавления 1% недостаточно для полного покрытия. Checkout показывает стоимость заказа и точную сумму перевода, без отдельной строки комиссии. Отправлять нужно ровно показанную сумму. QR содержит только адрес, сумма вводится в кошельке отдельно.

Действующие интеграции магазинов

Обычный запрос и его ключ идемпотентности остаются прежними. При включённой настройке BramaPay фиксирует контракт PROJECT_BUYER_FEE_V1. Прежние amountUsd сессии/счёта, requestedAmount маршрута/счёта и amountUsd события оплаты сессии сохраняют стоимость заказа. Дополнительные payableAmountUsd и pricing описывают повышенную базу. Суммы переводов, квитанций, amountExpected и amountPaid остаются фактическими точными суммами. Товар или баланс выдаётся один раз на исходную стоимость заказа. Подписанное событие сверяется с авторизованным GET; переход по return URL оплату не подтверждает.

Уникальная дробная часть не является сервисной комиссией и не увеличивает баланс покупателя в магазине. Внутренний учёт и комиссия BramaPay используют повышенную базу. Платёж покупателя не пополняет сервисный баланс мерчанта и не отменяет блокировку новых счетов при фактическом балансе плюс лимите, равном нулю или ниже.

Совместимость явного API opt-in

Выпущенный ранее BUYER_FEE_V1 сохранён: передаются feePayer: "BUYER", pricingVersion: "BUYER_FEE_V1" и baseAmountUsd вместо обычного поля суммы. В этом явном контракте amountUsd по-прежнему означает повышенную базу. Старые котировки не меняются. Эти два версионных контракта нужно различать.

Явный MERCHANT не обходит включённую настройку проекта. Повторный запрос возвращает первоначальное решение, даже после переключения галочки. При неизвестном результате используйте прежние тело и ключ идемпотентности.

В Test ставка пробная 1%, без реальных комиссий, котировок и оборота Live. Ошибочные, поздние, повторные и избыточные переводы обрабатываются по действующим правилам поддержки; автоматические возвраты и дополнительные зачисления не вводятся.