跳转到主要内容
POST
迁移套餐

迁移套餐

把您账户在该地址上的所有活跃和已暂停套餐连同其全部剩余转账次数一并迁移到新地址。不能单独迁移其中某一个套餐。当发送转账的钱包更换时使用。
  • 正在工作的套餐在新地址上继续工作。已暂停的套餐在新地址上保持暂停——需要时用新地址恢复它们。
  • 已支付的 24 小时在迁移期间继续计时,与暂停时相同。如果套餐在新地址上启动时这 24 小时已用完,会立即扣除一次转账;否则不扣除任何费用。
  • 迁移本身免费,迁移次数没有限制。
  • 如果新地址尚未在 TRON 网络上激活,将由您的账户出资激活,与购买时相同。
  • 响应之后,来自旧地址的转账不再获得服务,也不再计入套餐。
新地址上必须没有任何账户的转账套餐,也没有处于活跃状态的智能模式。
该调用约 15 秒或更久后返回——请把客户端超时设为 60 秒。系统会先停止向旧地址供应,并统计已从该地址发出的转账。响应之后从旧地址发出的转账将得不到能量。请等到响应后再切换钱包。

请求体

string
必填
套餐当前所在的 TRON 地址
string
必填
要把套餐迁移到的 TRON 地址。必须与 address 不同,且不能是智能合约

响应

string
新地址——套餐现在所在的地址。
string
套餐迁出的地址。
array
已迁移的套餐——与套餐列表中的对象相同,address 为新地址。原本在工作的套餐 status 为 active(paused_at 为 null),原本已暂停的套餐为 paused。

示例

此例中套餐原本在工作,已支付的 24 小时尚未用完,因此未扣费:subscription_used 和 remaining 与迁移前相同。
Response

Webhooks

迁移正在工作的套餐时,会先在旧地址上暂停、再迁移、然后在新地址上恢复,因此每个套餐按以下顺序发送三个事件:
  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 也可能在这一步出现。此时套餐在旧地址上处于暂停;请重复迁移以带走它们——它们到达新地址时为暂停状态。
出现任何错误后,套餐列表会显示每个套餐在哪里、处于什么状态。