Перейти к основному содержанию
POST
Перенести пакеты

Перенести пакеты

Переносит на новый адрес все активные и приостановленные пакеты вашего аккаунта на адресе вместе со всеми их оставшимися переводами. Перенести один пакет отдельно нельзя. Используйте, когда меняется кошелёк, с которого отправляются переводы.
  • Работавшие пакеты продолжают работать на новом адресе. Приостановленные остаются на паузе — возобновите их с новым адресом, когда они понадобятся.
  • Оплаченные 24 часа продолжают идти через перенос, как и через паузу. Если к моменту запуска пакетов на новом адресе они истекли, один перевод списывается сразу; иначе ничего не списывается.
  • Сам перенос бесплатный, частота переносов не ограничена.
  • Если новый адрес ещё не активирован в сети TRON, он активируется за счёт вашего аккаунта, как при покупке.
  • Переводы со старого адреса после ответа больше не обслуживаются и не учитываются.
На новом адресе не должно быть пакетов переводов ни одного аккаунта и активного Smart Mode.
Вызов отвечает примерно за 15 секунд или дольше — задайте таймаут клиента 60 секунд. Сначала останавливается доставка на старый адрес, а уже отправленные с него переводы учитываются. Перевод со старого адреса после ответа не получит энергию. Дождитесь ответа, прежде чем переключать кошелёк.

Тело запроса

string
обязательно
Адрес TRON, на котором пакеты сейчас
string
обязательно
Адрес TRON, на который нужно перенести пакеты. Должен отличаться от address и не должен быть смарт-контрактом

Ответ

string
Новый адрес — где пакеты находятся теперь.
string
Адрес, с которого пакеты перенесены.
array
Перенесённые пакеты — те же объекты, что в Списке пакетов, с address, равным новому адресу. status — active у работавших пакетов (paused_at равен null) и paused у приостановленных.

Пример

Здесь пакет работал, а оплаченные 24 часа не истекли, поэтому ничего не списано: subscription_used и remaining такие же, как до переноса.
Response

Вебхуки

Перенос работающих пакетов приостанавливает их на старом адресе, переносит и возобновляет на новом, поэтому по каждому пакету уходят три события в таком порядке:
  1. package.paused со старым address;
  2. package.moved с новым address и старым в previous_address;
  3. package.resumed с новым address.
Перенос приостановленных пакетов отправляет только package.moved. События отправляются в этом порядке, но доставляются независимо, поэтому могут прийти в другом — сравнивайте timestamp конверта или читайте текущее состояние из Списка пакетов.

Ошибки

Приходят в стандартной форме, в detail.error.code. Эти ошибки возникают до любых изменений и списаний — пакеты продолжают работать на старом адресе: Эти ошибки возникают при остановке доставки на старом адресе. Ничего не перенесено, пакеты продолжают работать на старом адресе. Если новый адрес был активирован до ошибки, списание за активацию остаётся — адрес остаётся активированным для следующего переноса: Эти ошибки возникают после того, как доставка на старый адрес остановлена. В сообщении сказано, где пакеты сейчас: ADDRESS_BUSY и MOVE_AFTER_PAUSE могут прийти и на этом шаге, если между операциями вклинилась другая операция по адресу. Тогда пакеты на паузе на старом адресе; повторите перенос — они приедут на паузе.
После любой ошибки Список пакетов покажет, где находится каждый пакет и в каком он статусе.