Гайд: direct-касса

Подключите собственный кошелёк: xPub для EVM и BTC, статический адрес + уникальные суммы для TRON/TON, view key для Monero.

Direct-касса полностью некастодиальна: покупатели платят прямо в ваш кошелёк, а ZeroKYC Pay только наблюдает цепочку и шлёт вебхуки. Приватные ключи не касаются платформы — вы подключаете публичный указатель (xPub, адрес или view key) по каждому активу. Тариф — плоская подписка $29/$79 + 0.5% overage.

Режимы подключения по активам

Актив	Режим	Что вы указываете	Как работает матчинг
USDC / USDT (Polygon, Arbitrum)	`xpub`	Account xPub (BIP44)	Свежий деривированный адрес на инвойс, матчинг по адресу
BTC	`btc_xpub`	BIP84 xPub	Свежий BIP84-адрес на инвойс, матчинг по адресу
USDT TRC-20	`static_amount`	Один TRON-адрес	Уникальные суммы у живых инвойсов
TON, USDT-TON	`static_amount`	Один TON-адрес	Уникальные суммы у живых инвойсов
XMR	`xmr_viewkey`	Основной адрес + приватный view key	Интегрированный адрес (payment id) на инвойс

Статический адрес + уникальные суммы

TRON- и TON-кошельки (и биржи) не экспортируют xPub, поэтому эти цепочки используют один статический адрес и различают инвойсы по сумме: живые инвойсы получают суммы с шагом 2 × amount_tolerance + 1 единица. При допуске ±0,1% инвойс на $101,1 получит $101,4, следующий — $101,7 — окна платежей никогда не пересекаются.

Правила, которые делают это безопасным:

Адрес должен использоваться исключительно через ZeroKYC Pay. Чужой перевод, случайно попавший в окно, даст вебхук payment.detected для ручного разбора, а не автоподтверждение.
Допуск 0 (по умолчанию) означает точное совпадение до минимальной единицы.
Подтверждения и правила курсов те же, что в транзите (таблица активов).

Подключение xPub (EVM, BTC)

Вставьте account xPub один раз — платформа атомарно деривирует m/44'/60'/0'/0/i (EVM) или BIP84-адреса на каждый инвойс. xPub умеет порождать адреса, но не тратить — именно поэтому режим некастодиален. Опционально прогоните пробную деривацию для валидации перед запуском.

View key Monero

Укажите основной XMR-адрес и приватный view key — секрет, который видит входящие переводы, но не может их потратить. Мы храним его зашифрованным at rest, генерируем интегрированный адрес (со встроенным payment id) на каждый инвойс и сканируем выходы собственной нодой monerod с резервной.

Шпаргалка по кастодии
direct xpub       → ключи: ваши. у платформы: только публичный ключ
direct static     → ключи: ваши. у платформы: сам адрес
direct view key   → ключи: ваши. у платформы: view-секрет (зашифрован),
                    умеет наблюдать входящие, не умеет тратить
transit           → у платформы: временный горячий ключ до свипа

Биллинг и cutoff

Расчётный цикл — каждые 30 дней с момента регистрации (или смены тарифа). Первые 30 дней бесплатны — подписка Starter включается на 30-й день и оплачивается в USDT (TRC-20) через наш hosted-чекаут. Неоплаченный счёт платформы запускает grace-период 7 дней; после него создание новых инвойсов возвращает 402 account_suspended до оплаты. Живые инвойсы, чекаут и вебхуки ваших покупателей не прерываются никогда — а 30 дней в suspension архивируют аккаунт.

Что видит покупатель

Тот же hosted-чекоут с одной разницей: на direct платёжный адрес деривирован из вашего кошелька — в этом весь смысл.