SELF-HOSTED USDT REST API И WEBHOOKS

Документация для разработчиков

POST/v1/auth/register · /v1/auth/verify-email

Аутентификация, Email и HMAC

Регистрация мерчантов защищена обязательной верификацией email по одноразовой ссылке/токену. Серверные интеграции используют API-ключ и каноническую подпись HMAC-SHA256.

ДЕТАЛИ ИНТЕГРАЦИИ

  • [01]После регистрации POST /v1/auth/register на почту отправляется токен подтверждения; подтверждение выполняется через POST /v1/auth/verify-email (повторная отправка — /v1/auth/resend-verification).
  • [02]Для серверных вызовов передавайте заголовки X-Api-Key, X-Timestamp (Unix-время в секундах) и X-Signature (HMAC-SHA256 от ${timestamp}.${method}.${path}.${sha256(body)}).
  • [03]Используйте Idempotency-Key (UUID v4) для безопасных повторов создания сессий и выплат в течение 24 часов.

ПАРАМЕТРЫ И ЗАГОЛОВКИ

email
строкаОБЯЗАТЕЛЬНО

Корпоративный email для входа и верификации аккаунта.

token
строкаОБЯЗАТЕЛЬНО

Токен верификации email из письма для POST /v1/auth/verify-email.

X-Api-Key
строкаОБЯЗАТЕЛЬНО

Секретный ключ проекта (sk_live_... или sk_test_...).

X-Signature
hex-строкаОБЯЗАТЕЛЬНО

Hex-дайджест HMAC-SHA256, вычисленный секретным ключом вебхука/API.

Idempotency-Key
UUID

Ключ идемпотентности для предотвращения дублирующих операций.