← Все уроки

УРОК 10 / 10

Принимай оплату для нескольких продавцов.

Один платёж клиента, отдельные балансы и контролируемые выплаты.

Что получится

Оплата для трёх продавцов с комиссией 4% и проверенными правилами выплат.

1. Подготовь проект

Открой Проект → 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 предоплаты. Сетевые комиссии отдельно.

В выплатах подготовь доступные доли, ограничь нативные комиссии и газ. Bitcoin требует все неоплаченные доли счёта в одном пакете. Проверь точных получателей и план, одобри один раз и дождись Paid, а не только Broadcast.

5. Осторожно включи автоматизацию

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

Автоматические правила отправляют без новых кликов. Низкий баланс или блокировка переводов приостанавливают расходы, но наблюдение и журнал работают.

6. Решай проблемы без повторных выплат

  • Недоплата: допуск не создаёт необеспеченных балансов. Дождись доплаты, верни средства или явно одобри меньшую обеспеченную долю.
  • Не хватает газа: добавь свободные нативные монеты и проверь сохранённую выплату. Не создавай вторую для обхода.
  • Тайм-аут webhook: повтори то же подписанное событие. Проверь подпись исходного тела и проект, сохрани уникальный event_id, затем подтверди. Счёт погашен: не значит выплата завершена.
  • Возврат после выплаты продавцам: отдельно пополни основной адрес, проверь адрес клиента, подготовь полный возврат в том же активе и одобри. У продавцов автоматически не списывается.
  • Восстановление или неизвестная отправка: держи выплаты на паузе и сверь сохранённые хэши до продолжения. Тайм-аут не доказывает, что ничего не отправлено.

Заметки по работе · API, разрешения и события