Supplier Accounts

Supplier Account это учётная запись у поставщика Stars/Premium (сессия + кошелёк, с которого платится). Через них платформа выполняет ваши заказы.

Зачем изоляцияCopy Anchor Link

Если все продукты платят через одну сессию и один кошелёк, одна блокировка останавливает всех сразу, а кошелёк может отправлять только одну транзакцию за раз. Поэтому:

• в режиме OWN у вас свои аккаунты: ваши заказы выполняются только ими, и они никогда не используются для чужих заказов;
• в режиме PLATFORM заказы выполняет пул Platform, а вы платите с баланса (Цены и баланс);
• проблема с аккаунтом другого партнёра не затрагивает ваши заказы.

Как подключить свой аккаунтCopy Anchor Link

Данные сессии и кошелька передаются один раз через кабинет. Мы храним их только в зашифрованном виде (AES-256-GCM), расшифровываем лишь в момент обращения к поставщику и никогда не отдаём обратно: ни в API, ни в логах. В кабинете видны только адрес кошелька и дата обновления сессии.

ТроттлингCopy Anchor Link

• Один аккаунт выполняет не больше одного заказа за раз и по умолчанию не чаще одного заказа в минуту (интервал настраивается).
• Пропускная способность растёт числом аккаунтов: пул из N аккаунтов даёт около N заказов в минуту.
• Когда все аккаунты заняты, заказ ждёт в QUEUED без траты попыток.

ЗдоровьеCopy Anchor Link

Платформа сама следит за аккаунтами: проверяет сессию и баланс кошелька, после серии ошибок ставит аккаунт на короткую паузу. Здоровье: HEALTHY, DEGRADED, UNHEALTHY или UNKNOWN; причины: SESSION_EXPIRED, LOW_BALANCE, WALLET_UNREACHABLE, SUPPLIER_ERRORS. Изменение здоровья ваших аккаунтов приходит вебхуком supplier_account.health_changed, например, чтобы вовремя пополнить кошелёк или обновить сессию.