Форма оплати для трьох продавців із комісією 4% та перевіреною політикою виплат.
1. Підготуй проєкт
Відкрий Проєкт → Marketplace → Налаштування. Увімкни Marketplace і вибери магазини-учасники. Поки залиш виплати призупиненими. Зроби резервні копії гаманців проєкту й увімкни Bitcoin або підтримувані способи оплати EVM у кожному магазині.
Клієнти спочатку платять у ці гаманці проєкту. Ти контролюєш ключі та маєш зобов’язання перед продавцями на суми записаних балансів. Залишай окремі вільні нативні монети для комісій. Звичайний sweep не може витрачати кошти з адрес отримання Marketplace.
2. Додай і схвали трьох продавців
У розділі «Продавці» додай кожного продавця та адресу Bitcoin mainnet. Незалежно підтвердь адресу з продавцем, перш ніж схвалювати її. Для токенів EVM кожному продавцю також потрібна схвалена адреса саме в цій мережі.
Установи комісію проєкту 4%. Перевизначення на рівні магазину, продавця й авторизованого рахунку зберігаються у знімку, тому подальші зміни не впливають на наявний розподіл.
3. Створи спільний рахунок
У Marketplace → Рахунки створи рахунок на 300 USD із трьома валовими частками продавців по 100 USD. Їхня сума має точно збігатися. Надішли клієнту посилання на форму оплати.
Для інтеграції через API використовуй окремий ключ Marketplace і надсилай десяткові рядки до /v1/marketplace/invoices. Збережи ключ ідемпотентності перед запитом і використовуй його повторно після тайм-ауту. Приклади запитів →
4. Перевір і надішли
Дочекайся, поки перевірені розподілені суми стануть доступними. За зафіксованим котируванням кожен продавець отримує еквівалент 96 USD в активі оплати, а ти залишаєш собі комісію в еквіваленті 12 USD. Наявна комісія за обробку 1%, якщо її налаштовано, коштує 3 USD із передплаченого балансу. Комісії мережі - окремо.
У розділі «Виплати» підготуй доступні розподілені суми та обмеж комісії в нативній монеті й gas. Для Bitcoin усі невиплачені частки вибраного рахунку мають бути в одному пакеті. Перевір точних отримувачів і план, а потім схвали один раз. Відстежуй до стану «Виплачено», а не лише «Трансльовано».
5. Обережно ввімкни автоматизацію
У налаштуваннях додай політику для одного активу: мінімальну виплату, ліміти основної суми на виплату й на день, бюджети комісій у нативній монеті та gas, інтервал і підтвердження. Увімкни її лише після перевірки цих лімітів та адрес призначення, а потім віднови виплати.
Автоматичні політики можуть надсилати кошти без додаткових натискань. Низький баланс коштів на обробку або серверне блокування переказів усе одно призупиняють витрачання. Моніторинг і журнал обліку продовжують працювати.
6. Обробляй винятки без повторного надсилання коштів
- Недоплата: допуск форми оплати не створює незабезпечених балансів продавців. Дочекайся доплати, поверни кошти або явно схвали менший, повністю забезпечений розподіл.
- Бракує gas для токена: додай вільні нативні монети до гаманця проєкту та перевір утриману виплату. Не створюй другу виплату, щоб обійти її.
- Тайм-аут webhook: повтори ту саму підписану подію. Перевір її підпис над сирими даними та проєкт, збережи event_id з обмеженням унікальності, а потім підтвердь отримання. Подія остаточної оплати рахунку не означає завершення виплати.
- Повернення після виплат продавцям: окремо поповни основний гаманець, перевір адресу клієнта, підготуй повне повернення в тому самому активі та схвали його. Кошти з продавців автоматично не списуються.
- Відновлення або невизначений результат трансляції: залиш виплати призупиненими та звір збережені хеші транзакцій перед відновленням роботи. Ніколи не вважай, що тайм-аут означає відсутність надсилання.