Гайд: direct-касса
Подключите собственный кошелёк: один статический адрес + уникальные суммы для всех активов, кроме Monero (view key).
Direct-касса полностью некастодиальна: покупатели платят прямо в ваш кошелёк, а ZeroKYC Pay только наблюдает цепочку и шлёт вебхуки. Приватные ключи не касаются платформы — вы подключаете адрес (или view key для Monero) по каждому активу. Тариф — плоская подписка $29/$79 + 0.5% overage.
Режимы подключения по активам
| Актив | Режим | Что вы указываете | Как работает матчинг |
|---|---|---|---|
| BTC, LTC, DOGE, BCH | static_amount | Один Bitcoin (bc1…) / Litecoin (ltc1…) / Dogecoin (D…) / Bitcoin Cash (q…) адрес | Уникальные суммы у живых инвойсов |
| XRP | static_amount | Один адрес XRP Ledger (r…) | Уникальные суммы у живых инвойсов |
| NEAR | static_amount | Один NEAR-аккаунт (name.near или 64-hex) | Уникальные суммы у живых инвойсов |
| SOL, USDT/USDC (Solana) | static_amount | Один адрес кошелька Solana (base58) | Уникальные суммы у живых инвойсов |
| ETH, USDT (Ethereum), USDT (BSC), BNB, USDT (Arbitrum), USDC, USDT (Polygon), USDC (Arbitrum) | static_amount | Один EVM-адрес из любого кошелька | Уникальные суммы у живых инвойсов |
| USDT TRC-20, TRX | static_amount | Один TRON-адрес | Уникальные суммы у живых инвойсов |
| TON, USDT-TON | static_amount | Один TON-адрес | Уникальные суммы у живых инвойсов |
| XMR | xmr_viewkey | Основной адрес + приватный view key | Интегрированный адрес (payment id) на инвойс |
Статический адрес + уникальные суммы
Обычные кошельки (и биржи) не экспортируют xPub, поэтому все активы, кроме Monero, используют один статический адрес и различают инвойсы по сумме: живые инвойсы получают суммы с шагом 2 × amount_tolerance + 1 единица. При допуске ±0,1% инвойс на $101,1 получит $101,4, следующий — $101,7 — окна платежей никогда не пересекаются.
Правила, которые делают это безопасным:
- Адрес должен использоваться исключительно через ZeroKYC Pay. Чужой перевод, случайно попавший в окно, даст вебхук
payment.detectedдля ручного разбора, а не автоподтверждение. - Допуск
0(по умолчанию) означает точное совпадение до минимальной единицы; для стейблкоинов практичный диапазон — ±0,0001–0,001 — консоль показывает итоговый шаг окна вживую. - Подтверждения и правила курсов задаются по активам (таблица активов).
View key Monero
Укажите основной XMR-адрес и приватный view key — секрет, который видит входящие переводы, но не может их потратить. Мы храним его зашифрованным at rest, генерируем интегрированный адрес (со встроенным payment id) на каждый инвойс и сканируем выходы собственной нодой monerod с резервной.
Шпаргалка по кастодии
direct static → ключи: ваши. у платформы: сам адрес
direct view key → ключи: ваши. у платформы: view-секрет (зашифрован),
умеет наблюдать входящие, не умеет тратить
Биллинг и cutoff
Расчётный цикл — каждые 30 дней с момента регистрации (или смены тарифа). Первые 30 дней бесплатны — подписка Starter включается на 30-й день и оплачивается в USDT (TRC-20) через наш hosted-чекаут. Неоплаченный счёт платформы запускает grace-период 7 дней; после него создание новых инвойсов возвращает 402 account_suspended до оплаты. Живые инвойсы, чекаут и вебхуки ваших покупателей не прерываются никогда — а 30 дней в suspension архивируют аккаунт.
Что видит покупатель
Тот же hosted-чекоут с одной разницей: на direct покупатели платят сразу на ваш адрес — в этом весь смысл.
Полный гайд по подключению — от получения ключей до первого подтверждённого платежа: Подключение.