Если что-то не так

Пополнения

Моё пополнение не пришло

Пройдите по списку:

1. Дайте сети немного времени. Зачисление происходит после подтверждения пополнения в блокчейне, а не в момент отправки.
2. Проверьте сеть. Депозитный адрес — в сети TRON (TRC-20). USDT, отправленные из Ethereum, BNB Chain или по внутренней сети биржи, до него не доходят — и вернуть их нельзя.
3. Проверьте минимум. Пополнения меньше минимума, указанного в окне Пополнить, могут не зачислиться.
4. Проверьте адрес. Это должен быть адрес из вашего собственного окна Пополнить, а не из гайда или скриншота.

Когда деньги зачислятся, вы получите уведомление deposit.credited, а операция появится в История.

Можно ли пополнять сразу в TRX?

Да. Баланс ведётся в TRX, поэтому пополнение в TRX обходится без конвертации. USDT-TRC20 конвертируется по текущему курсу при поступлении.

Заказы

У заказа статус Created, а не Filled

Какое-то время это нормально. Заказ получает статус Created, когда мы приняли оплату и начали доставку, и становится Filled, когда доставка подтверждена, — обычно за секунды.

Не опрашивайте его в цикле. Он завершится сам, а вы получите уведомление (или вебхук order.filled).

Заказ не выполнился — где мои деньги?

На вашем балансе. Невыполненный заказ возвращается автоматически; возврат вы увидите в История и получите уведомление order.failed. Если на балансе этого не видно, сообщите нам id заказа.

Почему вышло дороже, чем в превью?

Почти всегда причина — активация адреса: адрес, с которого ещё не было транзакций в TRON, нужно активировать один раз, это дополнительные 2 TRX. Превью учитывает её, только если вы указали адрес до того, как смотреть на сумму. Запустите превью заново с адресом на месте — и сумма совпадёт.

Энергия пришла, но потом пропала

Арендованная энергия временная — она возвращается, когда истекает выбранный срок аренды. Если нужно, чтобы она держалась дольше, арендуйте на больший срок или используйте автоматизацию, чтобы запас пополнялся.

Автоматизации

Моё правило само встало на паузу

Баланса не хватило на следующую поставку, и мы поставили правило на паузу, а не дали ему упасть. Пополните баланс и возобновите.

Включите Возобновлять автоматически — и это лечится само: правило, приостановленное системой, запустится снова, как только баланса опять хватит на поставку. Правило, которое поставили на паузу вы, автоматически не возобновляется никогда — это сделано намеренно.

Я пополнил баланс, но правило не возобновилось

Проверьте три вещи:

1. Включено ли авто-возобновление? Оно включается отдельно для каждого правила.
2. Хватает ли на полную поставку? Возобновление на балансе, которого не хватает на одно срабатывание, тут же снова поставило бы правило на паузу, поэтому этого не происходит.
3. Кто поставил на паузу? Если вы сделали это вручную, запустить снова может только вы.

Правило активно, но ничего не доставляется

Если активное правило молчит дольше, чем следует из его расписания, мы это обнаруживаем и отмечаем внутри. Если адрес не получает энергию, а правило выглядит исправным, напишите нам, указав правило и адрес, — не удаляйте и не создавайте его заново: так теряется история, по которой мы бы искали причину.

Можно ли автоматизировать bandwidth?

Нет. Автоматизации работают только с энергией — bandwidth доступен как разовая покупка. Закажите его вручную в разделе Купить энергию.

API и агенты

403 api_key.insufficient_scope

Ключу нельзя это делать. Scope вложены друг в друга: full ⊇ purchase ⊇ read. Для чтения нужен read, для трат (заказы, автоматизации) — purchase, для управления вебхуками — full. Выпустите ключ с нужным scope — см. Аутентификация.

403 api_key.spend_limit_exceeded

Ключ достиг дневного лимита трат. Лимит действует на каждый ключ, за календарный день UTC, и учитывает как заказы, которые сделал ключ, так и поставки автоматизаций, созданных этим ключом. Увеличьте лимит или дождитесь смены дня.

Это работает как задумано — именно такой ограничитель делает безопасным передачу ключа агенту.

402 wallet.insufficient_balance

Не хватает TRX. Эта ошибка также возникает при создании продления или включении smart-режима, потому что для обоих на балансе заранее должно хватать как минимум на одну поставку.

Я потерял API-ключ

Ключи показываются один раз и хранятся в виде хэша — восстановить его мы не можем. Отзовите его и выпустите новый.

Вебхуки

Доставки не приходят

Сначала посмотрите журнал доставок эндпоинта в кабинете — он показывает каждую попытку и ответ, который мы получили. Затем:

1. Включён ли эндпоинт? Отключённые эндпоинты пропускаются молча.
2. Возвращаете ли вы 2xx? Любой другой ответ считается сбоем и повторяется (примерно от 30 с до 6 ч, до 6 попыток), после чего доставка помечается как неудачная.
3. Подписаны ли вы на это событие? Эндпоинт получает только те типы событий, которые вы для него выбрали.
4. Отправьте тестовое событие, чтобы проверить путь целиком.

Не получилось добавить эндпоинт?

Мы принимаем только публичные HTTPS-адреса. http://, localhost и частные или внутренние IP-адреса отклоняются при добавлении эндпоинта — так что при локальной разработке поставьте перед приёмником туннель.

Не проходит проверка подписи

Почти всегда причина одна из этих:

1. Вы проверяли разобранное тело. Подписывайте сырые байты — до любого разбора JSON или повторной сериализации: перекодированное тело отличается пробелами, и HMAC не совпадёт.
2. Вы не учли метку времени. Подписанная строка — это {timestamp}.{rawBody}, а не одно тело.
3. Вы обновили секрет, а у приёмника остался старый.

Формат и рабочий пример есть в справочнике по вебхукам.

Я получил одно и то же событие дважды

Так и задумано — из-за повторов доставка работает по принципу at-least-once (минимум один раз). Дедуплицируйте по заголовку X-TronGas-Delivery.