Перейти к основному содержимому

Начало API-интеграции

Используйте API-ключ собственного аккаунта Heth. Сначала прочитайте об авторизации, суммах и статусах и доступных бизнес-функциях.

Проверить доступ без движения денег​

Сохраните HETH_API_KEY в хранилище секретов интеграции. Не помещайте его в репозиторий, клиентский код, URL или переписку с ИИ. Этот запрос читает историю аккаунта без движения денег.

curl --get 'https://app.heth.me/api/v1/transactions' \
  --header "x-api-key: $HETH_API_KEY" \
  --data-urlencode 'env=prod' \
  --data-urlencode 'limit=10' \
  --data-urlencode 'order_by=started'

Пустой массив data — допустимый результат. При ответе 401 или 403 проверьте авторизацию и права аккаунта.

Первый платёж​

  1. Проверьте доступные вашему аккаунту платёжные маршруты и получите реквизиты получателя или платёжного инструмента.
  2. Выберите нужный пример транзакции и замените все заполнители проверенными реквизитами своей операции.
  3. Используйте небольшую сумму: для USDT с шестью знаками "1000000" означает 1 USDT.
  4. До отправки создайте и сохраните уникальный txid бизнес-операции.
  5. Отправьте запрос один раз, сохраните id и проверьте статус.
  6. При таймауте найдите исходную операцию по txid или повторите идентичный запрос с тем же идентификатором. Новый идентификатор не создавайте.

Отправка платёжного запроса может привести к списанию реальных средств. До отправки проверьте получателя, сумму, валюту, сеть и комиссии. API-ключ разрешает только операции, доступные его аккаунту.

Последнее обновление