Как принимать USDT платежи на вашем сайте

Узнайте, как принимать USDT платежи на блокчейне TRON с платёжным шлюзом Pulse2Pay. Это руководство охватывает всё от настройки аккаунта до развёртывания в продакшене.

Предварительные требования

Перед началом вам понадобится:

Мерчант-аккаунт Pulse2Pay (зарегистрируйтесь здесь)

API учётные данные (API Key и Secret)

Webhook endpoint на вашем сервере

Базовое понимание REST API

Шаг 1: Получите API учётные данные

Войдите в панель управления

Перейдите в Настройки > API ключи

Нажмите "Сгенерировать новые ключи"

Сохраните ваш API Key (pk_live_) и API Secret (sk_live_)

Важно: API Secret показывается только один раз. Храните его надёжно и никогда не используйте в клиентском коде.

Шаг 2: Создание платежа

Для создания платежа отправьте POST-запрос к нашему API:

curl -X POST https://api.pulse2pay.com/api/merchant/v1/payments \
  -H "Content-Type: application/json" \
  -H "X-Pulse2Pay-Key: pk_live_your_api_key" \
  -H "X-Pulse2Pay-Signature: your_hmac_signature" \
  -H "X-Pulse2Pay-Timestamp: 1705320000000" \
  -d '{
    "amount": "100.00",
    "currency": "USDT",
    "network": "TRON",
    "tokenStandard": "TRC20",
    "metadata": {
      "customer_email": "[email protected]"
    }
  }'

Ответ включает уникальный TRON адрес для отправки USDT:

{
  "paymentId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "pending",
  "amount": "100.00",
  "currency": "USDT",
  "network": "TRON",
  "generatedAddress": "TXyz...abc123",
  "expiresAt": "2025-01-15T12:30:00.000Z"
}

Шаг 3: Отображение инструкций

Покажите клиенту:

Сумму USDT для отправки

TRON адрес (с QR-кодом)

Срок оплаты (30 минут)

Шаг 4: Обработка Webhooks

После подтверждения платежа мы отправим webhook:

{
  "id": "evt_a1b2c3d4_1705078500000",
  "type": "payment.confirmed",
  "createdAt": "2025-01-15T12:05:00.000Z",
  "data": {
    "paymentId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "status": "confirmed",
    "amount": "100.00",
    "currency": "USDT",
    "network": "TRON",
    "netAmount": "99.00",
    "feeAmount": "1.00",
    "txHash": "abc123...",
    "generatedAddress": "TXyz...abc123",
    "confirmations": 19
  }
}

Всегда проверяйте подпись webhook. См. руководство по безопасности webhook.

Лучшие практики

Всегда проверяйте webhooks: Используйте HMAC подписи

Обрабатывайте граничные случаи: Платежи могут истечь или быть недоплачены/переплачены

Показывайте чёткие инструкции: Отображайте точную сумму и адрес

Используйте ключи идемпотентности: Используйте idempotencyKey

Следующие шаги

Руководство по безопасности Webhook

API Reference

Тарифы и комиссии