Proxy-seller

自动续订

Updated:

适用于所有类型的代理,包括住宅套餐。

权限:account:read,account:write,计费:撰写

calc_autoprolong_cost

🟢read-only · account:read

下一次自动扣款及其日期,内容保持不变。

采用与enable_autoprolong.

返回: {total, discount, quantity, orders, balance, items[], days | tarifId, chargeDate, dateEnd, paymentId, autoProlong, warning, currency: "USD"}.items 是需要续期的代理(形式与list_proxies,password (已屏蔽),chargeDate 是指资金必须在账户余额中(null (用于住宅),autoProlong 显示每个选定代理是否已启用。当推断出该时间段时,periodId 以及一个_note 请指明具体是哪一个。已根据 2026-10-06 版本的 Stage API 进行验证。

enable_autoprolong

💳spends money · billing:write

开启自动续订功能。目前不会产生任何费用,但未来的续订将自动扣费。

参数

类型

描述

type 必填

代理类型

产品类型

paymentId 必填

字符串

balance 或paddle_subscription

ips /ids /orderIds

数组

哪些代理,按类型分类,例如make_prolong (orderIds foripv6 /mix /mix_isp); 对于resident

periodId

字符串

续订周期对应价格。可选:若已开启自动续订,则按绑定周期计价;否则,服务器将根据代理当前的运行周期(基于其租赁期限)进行计价,并在结果中注明该周期名称。periodId 以及_note. 明确将其传递以确定另一个时段的价格

subscriptionId

字符串

使用paddle_subscription;摘自get_autotopup

tarifId

字符串

仅限住宅用户——必须符合当前资费标准

coupon

字符串

促销代码

calc_autoprolong_cost 采用相同的参数。

返回: {autoProlong: true, quantity, ids[], orderIds[], days, paymentId, chargeDate, dateEnd, warning} ——实际上被启用了什么(用于ipv6 /mix /mix_isp (一次性下达整个订单);不存在total,使用calc_autoprolong_cost 关于数量。已根据 2026-10-06 版本的 Stage API 进行验证。使用paddle_subscription 且不subscriptionId:{status: "not_enabled", paddleSubscription: {cardConnected, subscriptionId?, card?, nextSteps}} 且内容保持不变。

常见错误: 非空warning 意为自动续订正在进行中 但余额不足以支付下一笔费用——请在chargeDate。使用paddle_subscription 且无卡牌关联,结果为status: "not_enabled",内容保持不变。

disable_autoprolong

🟡changes account state · account:write

关闭自动续订功能。代理服务将保持有效直至当前到期日。

参数

类型

描述

type 必填

代理类型

产品类型

ips /ids /orderIds

数组

哪些代理,按类型分类,例如make_prolong (orderIds foripv6 /mix /mix_isp); 对于resident

后续步骤

On this page