开通

交付方式 activation 和 card_payment 会在您的客户的账号上开通订阅:下单后,客户需要提供自己的信息。一切都通过订单完成:需要索取什么、当前进展如何、可以执行哪些操作,订单本身都会告诉您。

更新于 2026年10月8日 · 阅读约需 13 分钟
Markdown

开通流程

  1. waiting等待客户信息

    订单中有 activation.customer_data_type(需要索取什么)和 activation.customer_instruction(给客户的现成文本)。提交客户发来的内容:POST /v1/orders/{order_id}/activate,请求体为 {"customer_data": "…"}。

  2. processing正在开通

    无需任何操作;status_text 会告诉客户需要等多久。

  3. completed订阅已开通。
如果没有一次成功
waiting
再次需要客户
信息不符合要求、账号上已有订阅,或服务方要求验证身份(activation.verification_link);具体原因见 status_text
processing
由我们处理
客户无需任何操作
failed
未能成功
我们已在排查;如果 available_actions 中有 retry,可以重试

每次变化都会推送 order.updated 事件,其中包含完整订单。不使用 Webhook 时,请调用 GET /v1/orders/{order_id}。

  1. 文本面向客户
    customer_instruction 和 status_text 是写给客户的,以「您」称呼,不含技术术语:请原样展示。
  2. 身份验证
    activation.verification_link:服务方要求客户验证身份。链接指向服务方自己的验证页面(Claude 为 inquiry.withpersona.com)或客户账号的设置页面;有效期见 activation.verification_until。客户完成验证后,调用 POST /v1/orders/{order_id}/verification-done(操作 verification_done);客户拒绝时,调用 POST /v1/orders/{order_id}/verification-declined(操作 verification_declined):订单将关闭,款项立即退回您的余额,再由您退还给客户。随后会推送 order.updated(status: canceled,status_text 为「客户拒绝了身份验证,款项已退回您的余额」)和带有退款记录的 balance.updated;客户在小组件中或在链接页面上拒绝时也是如此。客户信息进入处理后,您仍然不能自行 cancel:拒绝验证是无需联系客服、带退款关闭此类订单的唯一途径,且仅限服务方等待验证期间。
  3. 不要循环重试
    POST /v1/orders/{order_id}/retry 会使用已提交的信息重试。每次提交和每次重试都会发送给服务方。

需要向客户索取的信息

当订单等待客户时,订单中会给出所需信息的类型 activation.customer_data_type,并附带现成的提示文本 customer_instruction:

需要两种信息中的哪一种取决于商品:订单会在 customer_data_type 中注明。

claude_session_key
Claude 的 session key,以 sk-ant-sid02- 开头

需要使用电脑:登录 claude.ai,从 Chrome Web Store 安装 Claude Session Key 扩展程序,在扩展中点击「Copy to clipboard」,然后把复制的内容发送给我们。复制的内容以 sk-ant-sid02- 开头。

claude_org_id
Claude 账号的 Organization ID

请在浏览器中打开 claude.ai/settings/account,Organization ID 位于 Account 页面的最下方。请完整复制并发送给我们。该账号不能属于任何团队工作空间:如已加入,请先删除该工作空间或退出,否则订阅付款可能失败。Claude 应用中没有这个页面,只能在浏览器中打开。

请完整转发客户发来的内容:不要从 ChatGPT session 数据中删减字段,也不要去掉引号,多余的部分由我们自行清理。

客户看到的内容

status_text 是写给客户的订单进展说明。它随订单一起返回,可直接使用;此处列出,只是为了让您了解客户会看到什么。文本取决于商品的交付方式:

activation
waiting

等待客户信息 — 等待您提供开通所需的信息。

服务方要求验证身份 — 服务方要求对该账号进行身份验证。请打开链接完成验证,否则无法开通订阅。

需在设置中完成身份验证 — 服务方要求对该账号进行身份验证。请打开账号设置中的 General 选项卡,顶部会显示身份验证提示,点击「Verify」。不完成验证,订阅将无法开通。

验证链接已过期 — 身份验证链接已过期,请联系店铺客服,我们会发送新的链接。

账号已有订阅 — 该账号已有生效中的付费订阅,服务方不会再开通第二个。可以等现有订阅到期,也可以立即开通,但当前订阅的剩余天数将作废。

团队工作空间信息 — 这是团队工作空间的数据,而订阅只能开通到个人账号。请切换到个人账号后重新发送信息。

订阅来自 App Store 或 Google Play — 该账号的订阅是通过 App Store 或 Google Play 购买的,无法在网站上续订或替换。请在应用商店中取消订阅,待已付费期限结束后重新发送信息,或者发送另一个账号的信息。

信息无效 — 信息无效:可能没有复制完整或已过期。请重新打开页面,完整复制全部内容后再发送一次。

最近刚开通过 — 该账号最近已开通过订阅,服务方不允许立即重复开通。请过几个小时后再试。

processing

下单后立即 — 正在准备开通,约一分钟后告诉您需要提供哪些信息。

正在开通订阅 — 正在开通订阅,通常只需一两分钟。

工作人员处理中 — 我们的工作人员正在处理您的订阅,所需时间会比平时稍长,您无需任何操作。

客户已标记完成身份验证 — 已记录身份验证完成,正在继续开通。

服务方临时故障 — 服务方出现临时故障,我们正在处理,您无需任何操作。

我方正在准备 — 正在准备开通,需要稍长一些时间,您无需任何操作。

completed

订阅已开通 — 订阅已开通。

Grok 30 天套餐 — 订阅已开通:X Premium+ 已在您的 X 账号上开通。要在 Grok 中生效,请关联这个 X 账号:Grok → Settings → Account →「Connect your X Account」。如果您是通过 X 登录 Grok 的,则无需任何操作。

failed

未成功 — 订阅开通失败。我们正在排查,您无需任何操作。

所有交付方式
canceled订单已取消。canceled客户拒绝了身份验证,款项已退回您的余额。refunded已办理退款。

当暂停的原因无法用状态说明时(例如服务方出现故障,我们明天再试),我们会直接向客户说明情况,文本在 activation.note_to_customer 中:请将其原样展示在 status_text 旁边。

如果客户账号上已有生效中的订阅,订单中会有 activation.current_plan_until,表示该订阅的有效期截止日(如果服务方提供),available_actions 中会有 retry(订阅到期后再次检查),服务方允许时还会有 force。

格式错误

格式会在发送给服务方之前校验。客户信息不符合要求时返回 422 60005 invalid_customer_data,邮件中的链接不符合要求时返回 422 60006 invalid_login_link。两种情况下,message 都是给客户的现成文本,机器可读的原因在 details.problem 中:

60005
需要 ChatGPT 会话页面
expected_session_json需要完整复制 chatgpt.com/api/auth/session 页面上的全部文字。
expected_session_json_got_uuid这看起来只是部分信息,需要的是 chatgpt.com/api/auth/session 页面上的全部文字。
expected_session_json_got_token这看起来只是部分信息,需要的是 chatgpt.com/api/auth/session 页面上的全部文字。
session_json_broken文字没有复制完整,请复制整个页面的内容。
session_json_logged_out看起来您没有登录 ChatGPT。请在同一个浏览器中登录 chatgpt.com,然后重新打开该页面。如果链接是在 Telegram 或其他应用内打开的,请改用 Safari 或 Chrome 打开。
session_json_no_account复制的页面不对或不完整:需要在已登录 ChatGPT 的浏览器中打开 chatgpt.com/api/auth/session,并复制全部文字。
session_json_no_session_token复制的页面不对或不完整:需要在已登录 ChatGPT 的浏览器中打开 chatgpt.com/api/auth/session,并复制全部文字。

不常见但合法的格式会被接受:响应中会带有 warning 60100 customer_data_unusual,建议向客户再确认一次。

操作被拒绝

code 含义
60001 order_has_no_activation 该订单不需要开通:卡密或账号请从 GET /v1/orders/{order_id} 获取
60002 not_waiting_for_data 订单当前不在等待客户信息,请查看 status_text
60003 retry_not_available 当前无法重试
60004 force_not_available 当前无法在现有订阅上强制开通
60007 verification_not_requested 服务方并未要求客户进行身份验证
20003 too_many_activation_attempts 尝试次数过多,请等待 Retry-After

无法执行的原因见 details.problem:

details.problem 含义
kind_unknown 暂时还不知道需要向客户索取什么信息:请等待带有 customer_data_type 的 order.updated。新账号订单无需向客户索取任何信息。
login_started 正在等待邮件中的链接,请通过 activate 发送。
no_credential 没有可重试的内容:尚未发送过客户信息,请先调用 activate。
provider_ref_live 服务方仍在处理上一次提交,请等待 order.updated。
manual 我们的工作人员正在处理该订单,请等待 order.updated。
force_unavailable 目前不提供覆盖现有订阅的开通:账号上没有生效中的订阅,或服务方不支持这种方式。
terminal 开通已完成或已取消。
verification_not_requested 服务方没有要求客户进行身份验证,无需标记。验证请求位于 activation.verification_link,对应操作为 available_actions 中的 verification_done。

可执行的操作始终以 available_actions 为准:按它来显示按钮,就不会遇到这些错误。

本页内容是否有帮助?
发现错误?在 Telegram 联系我们