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

Документация

Один REST-запрос на приём платежа, одна проверка подписи для доверия. Первый sandbox-инвойс — примерно за 5 минут; production-интеграция с проверкой вебхуков обычно занимает один рабочий день.

Начните здесь

Подключение за 15 минут

Пошаговый гайд: аккаунт и ключи, первый инвойс, hosted-чекоут, вебхуки и HMAC, запуск в прод — со скопируемым кодом.

Быстрый старт

Создайте первый инвойс с payment_currency=any, отправьте покупателя в hosted-чекоут и получите подписанный вебхук.

Песочница и тестирование

Как работают pk_test-ключи и симулированная цепь, симуляция платежей из кабинета и end-to-end тест обработчика вебхуков.

Invoices API

Все мерчант-эндпоинты с примерами: создание, листинг, получение, отмена, QR-коды, а также events и payouts.

Жизненный цикл инвойса

Стейт-машина инвойса: статусы, статусы вариантов, observations, окна уникальных сумм и какой вебхук когда срабатывает.

Лимиты и идемпотентность

Лимиты на ключ с заголовками X-RateLimit и Retry-After, плюс семантика Idempotency-Key: реплеи, конфликты, 24-часовое окно.

Ошибки

Единый конверт ошибок и все восемь кодов: когда возникает каждый и как его обрабатывать.

Справочник вебхуков

Полный каталог событий с точными payload, заголовки и семантика доставки, лесенка ретраев 1м→12ч и правила идемпотентности.

SDK: PHP, Python, Node.js

Официальные SDK для PHP, Python и Node.js: установка, создание инвойсов с идемпотентными ключами и проверка подписи вебхуков одним вызовом.

Проверка HMAC-подписи

Проверка подписи вебхуков на Node.js, PHP и Python — сравнение за постоянное время и 5-минутное временное окно.

Сети: подтверждения и TTL

Пороги подтверждений по сетям (TRON, EVM включая Ethereum и BSC, BTC/LTC/DOGE/BCH, XRP, NEAR, Solana, TON, Monero) и правила TTL инвойсов: ожидание мемпула, истечение и рескан.

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

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

Справочник API (OpenAPI)

Интерактивная спецификация REST API: создание инвойсов, вебхуки, выводы, курсы валют и песочница.