Docs

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

Налаштування проєкту, точна сума переказу та сумісність інтеграцій.

Налаштування проєкту

У Налаштування → Проєкт → Комісія платежу власник може включити комісію 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 не підтверджує оплату.

Унікальна дробова частина не є сервісною комісією та не збільшує баланс покупця в магазині. Внутрішній облік і комісія використовують збільшену базу. Платіж не поповнює сервісний баланс мерчанта й не скасовує блокування нових рахунків за від’ємного балансу.

Сумісність явного API opt-in

Попередній BUYER_FEE_V1 збережено: feePayer: "BUYER", pricingVersion: "BUYER_FEE_V1" та baseAmountUsd замість звичайної суми. У цьому явному контракті amountUsd і далі означає збільшену базу. Видані котирування не змінюються. Розрізняйте ці два версійні контракти.

Явний MERCHANT не обходить увімкнену політику проєкту. Повторний запит повертає початкове рішення після зміни галочки. За невідомого результату повторюйте початкові тіло та ключ ідемпотентності.

Test використовує пробну ставку 1%, без реальних комісій, котирувань і обороту Live. Помилкові, пізні, повторні та надмірні перекази обробляються за чинними правилами підтримки; автоматичні повернення чи додаткові зарахування не вводяться.