Ваш первый платёж.

1. Получите API-ключ

Запросить доступ к бете : укажите название проекта, сайт или краткое описание, сценарий оплаты, ожидаемое число платежей в сутки и контакт для интеграции. Откройте инструкцию подачи заявки. После одобрения сохраните API-ключ в окружении сервера как DEDYX_API_KEY. Не включайте его в браузерные сборки, URL и репозиторий.

2. Настройте вебхук

Ограничение частоты: 10 запросов / 60 секунд (общий счётчик настроек вебхука · на мерчанта). Общие счётчики и дополнительные лимиты по IP.

curl -X PUT https://api.dedyx.com/api/v1/merchant/webhook \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"url":"https://your-company.example/webhooks/dedyx"}'

Для создания платежей нужен вебхук. Используйте публичный HTTPS-адрес на порту 443. Первый ответ содержит ваш собственный signing_key: сразу сохраните его безопасно, он показывается один раз. Приёмник должен проверять подпись до обработки событий.

3. Создайте страницу оплаты

Ограничение частоты: 30 запросов / 60 секунд (создание · на мерчанта). Общие счётчики и дополнительные лимиты по IP.

curl -X POST https://api.dedyx.com/api/v1/payments \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Idempotency-Key: order-1024' \
  -H 'Content-Type: application/json' \
  -d '{
    "amount": "49.00",
    "merchant_wallet": "TRzsBvFUhcvsy45ebmaKZ9EXw7zUorVkUm",
    "description": "Order #1024"
  }'

Используйте свой адрес TRON, точную десятичную сумму и новый Idempotency-Key для каждого заказа. При повторе используйте тот же ключ и тело запроса.

{
  "payment_id": "pay_0123456789abcdef0123456789abcdef",
  "expected_amount": "49.00",
  "status": "PENDING",
  "payment_url": "https://pay.dedyx.com/checkout/pay_0123456789abcdef0123456789abcdef"
}

Перенаправьте клиента на полученный payment_url. Стандартное окно оплаты — 30 минут. Страница показывает QR-код и обновляет статус.

4. Выполните заказ после проверенного события

Получите PAID вебхук на сервере. Проверьте HMAC-подпись, сопоставьте ID и сумму платежа с заказом, атомарно сохраните ID события вместе с выполнением заказа. Возвращайте 2xx для уже обработанного события.

Не выполняйте заказ только по перенаправлению браузера или скриншоту. Сервер может сверить статус через защищённый метод получения платежа.