Перейти к содержимому
ZeroKYC Pay

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

Подключите собственный кошелёк: один статический адрес + уникальные суммы для всех активов, кроме Monero (view key).

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

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

АктивРежимЧто вы указываетеКак работает матчинг
BTC, LTC, DOGE, BCHstatic_amountОдин Bitcoin (bc1…) / Litecoin (ltc1…) / Dogecoin (D…) / Bitcoin Cash (q…) адресУникальные суммы у живых инвойсов
XRPstatic_amountОдин адрес XRP Ledger (r…)Уникальные суммы у живых инвойсов
NEARstatic_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, TRXstatic_amountОдин TRON-адресУникальные суммы у живых инвойсов
TON, USDT-TONstatic_amountОдин TON-адресУникальные суммы у живых инвойсов
XMRxmr_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 покупатели платят сразу на ваш адрес — в этом весь смысл.

Полный гайд по подключению — от получения ключей до первого подтверждённого платежа: Подключение.