> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tronrental.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Перенос ваших пакетов переводов на новый адрес TRON

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

Переносит на новый адрес **все активные и приостановленные пакеты вашего аккаунта на адресе** вместе со всеми их оставшимися переводами. Перенести один пакет отдельно нельзя. Используйте, когда меняется кошелёк, с которого отправляются переводы.

* Работавшие пакеты продолжают работать на новом адресе. Приостановленные остаются на паузе — [возобновите](https://docs.tronrental.com/ru/api-reference/transfer-packages/resume.md) их с новым адресом, когда они понадобятся.
* Оплаченные 24 часа продолжают идти через перенос, как и через [паузу](https://docs.tronrental.com/ru/api-reference/transfer-packages/pause.md). Если к моменту запуска пакетов на новом адресе они истекли, один перевод списывается сразу; иначе ничего не списывается.
* Сам перенос бесплатный, частота переносов не ограничена.
* Если новый адрес ещё не активирован в сети TRON, он активируется за счёт вашего аккаунта, как при [покупке](https://docs.tronrental.com/ru/api-reference/transfer-packages/buy.md).
* Переводы со старого адреса после ответа больше не обслуживаются и не учитываются.

На новом адресе не должно быть **пакетов переводов** ни одного аккаунта и **активного Smart Mode**.

> [!WARNING]
>
> **Вызов отвечает примерно за 15 секунд или дольше** — задайте таймаут клиента 60 секунд. Сначала останавливается доставка на старый адрес, а уже отправленные с него переводы учитываются. Перевод со старого адреса после ответа не получит энергию. Дождитесь ответа, прежде чем переключать кошелёк.

### Тело запроса

**address** `string` *required*

Адрес TRON, на котором пакеты сейчас

**new\_address** `string` *required*

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

### Ответ

**address** `string`

Новый адрес — где пакеты находятся теперь.

**previous\_address** `string`

Адрес, с которого пакеты перенесены.

**packages** `array`

Перенесённые пакеты — те же объекты, что в [Списке пакетов](https://docs.tronrental.com/ru/api-reference/transfer-packages/list.md), с `address`, равным новому адресу. `status` — `active` у работавших пакетов (`paused_at` равен `null`) и `paused` у приостановленных.

### Пример

```bash theme={null}
curl -X POST https://api.tronrental.com/v1/transfer-packages/move \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "address": "TYourAddress...",
    "new_address": "TYourNewAddress..."
  }'
```

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

```json Response theme={null}
{
  "address": "TYourNewAddress...",
  "previous_address": "TYourAddress...",
  "packages": [
    {
      "id": 101,
      "user_id": 1234,
      "address": "TYourNewAddress...",
      "package_size": 500,
      "price_per_transfer": "2.7",
      "total_price_trx": "1350.0",
      "quota_total": 500,
      "quota_used": 187,
      "subscription_used": 3,
      "remaining": 310,
      "payment_method": "balance",
      "tx_hash": null,
      "paid_amount": null,
      "paid_currency": null,
      "is_single_transfer": false,
      "bw_guarantee": false,
      "status": "active",
      "next_subscription_at": "2026-11-18T10:00:00Z",
      "activated_at": "2026-11-15T10:00:00Z",
      "completed_at": null,
      "paused_at": null,
      "expires_at": null,
      "created_at": "2026-11-15T10:00:00Z"
    }
  ]
}
```

### Вебхуки

Перенос работающих пакетов приостанавливает их на старом адресе, переносит и возобновляет на новом, поэтому по каждому пакету уходят три [события](https://docs.tronrental.com/ru/api-reference/webhooks/overview.md) в таком порядке:

1. `package.paused` со старым `address`;
2. `package.moved` с новым `address` и старым в `previous_address`;
3. `package.resumed` с новым `address`.

Перенос приостановленных пакетов отправляет только `package.moved`. События отправляются в этом порядке, но доставляются независимо, поэтому могут прийти в другом — сравнивайте `timestamp` конверта или читайте текущее состояние из [Списка пакетов](https://docs.tronrental.com/ru/api-reference/transfer-packages/list.md).

### Ошибки

Приходят в [стандартной форме](https://docs.tronrental.com/ru/errors.md), в `detail.error.code`.

Эти ошибки возникают до любых изменений и списаний — пакеты продолжают работать на старом адресе:

| Код | Статус | Когда |
| - | - | - |
| `SAME_ADDRESS` | `400` | `new_address` совпадает с адресом пакетов |
| `ADDRESS_NOT_ALLOWED` | `400` | Перенести пакеты на этот адрес нельзя |
| `CONTRACT_ADDRESS_NOT_SUPPORTED` | `400` | `new_address` — смарт-контракт, а не кошелёк |
| `PACKAGE_NOT_FOUND` | `404` | У вашего аккаунта нет активного или приостановленного пакета на `address` |
| `PACKAGE_NOT_SETTLED` | `400` | Пакет на `address` ещё активируется — повторите позже |
| `ADDRESS_SHARED` | `400` | На `address` есть активный пакет другого аккаунта |
| `SMART_MODE_ACTIVE` | `400` | Smart Mode активен на `address` или на `new_address` — сначала отключите его |
| `ADDRESS_TAKEN` | `409` | На `new_address` уже есть пакеты переводов |
| `MOVE_AFTER_PAUSE` | `409` | Часть пакетов можно перенести только через 15 минут после паузы — [приостановите](https://docs.tronrental.com/ru/api-reference/transfer-packages/pause.md) их, подождите 15 минут, затем переносите |
| `INSUFFICIENT_BALANCE` | `402` | `new_address` нужно активировать, а вашего баланса не хватает |

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

| Код | Статус | Когда |
| - | - | - |
| `ADDRESS_BUSY` | `409` | По адресу выполняется другая операция — повторите через минуту |
| `PAUSE_BUSY` | `429` | Одновременно выполняется слишком много приостановок — повторите через минуту |
| `PROVIDER_UNAVAILABLE` | `503` | Не удалось остановить доставку энергии на старый адрес — повторите через минуту |

Эти ошибки возникают после того, как доставка на старый адрес остановлена. В сообщении сказано, где пакеты сейчас:

| Код | Статус | Где пакеты |
| - | - | - |
| `ADDRESS_TAKEN` | `409` | На паузе на **старом** адресе: во время переноса на `new_address` появился другой пакет. Сообщение заканчивается словами "stay paused on the old address; resume them there". Возобновите их там или перенесите на другой адрес |
| `MOVED_PAUSED` | статус причины | На паузе на **новом** адресе: перенос выполнен, но запустить доставку там не удалось. [Возобновите](https://docs.tronrental.com/ru/api-reference/transfer-packages/resume.md) с `new_address` |

`ADDRESS_BUSY` и `MOVE_AFTER_PAUSE` могут прийти и на этом шаге, если между операциями вклинилась другая операция по адресу. Тогда пакеты на паузе на старом адресе; повторите перенос — они приедут на паузе.

> [!TIP]
>
> После любой ошибки [Список пакетов](https://docs.tronrental.com/ru/api-reference/transfer-packages/list.md) покажет, где находится каждый пакет и в каком он статусе.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.