跳转到主要内容
客户门户是一个安全的托管区域，客户可以在其中管理订阅、查看发票并访问许可密钥详细信息——无需联系支持。

Create Portal Session (API)

通过编程方式创建安全的时限门户会话。

Subscriptions

管理定期计划、升级、降级和附加组件。

改版的客户门户，显示活跃订阅、支付方式和账单历史

​
什么是客户门户？

该门户为客户提供了一个可信的、品牌化的自助服务体验，客户可以：
  • Access billing history: 查看发票并下载收据。
  • Manage subscriptions: 查看订阅详情，即时取消订阅或在下一个计费日取消。
  • Update payment methods: 为活跃订阅更换支付方式或重新激活处于挂起状态的订阅。
  • Retrieve license keys: 访问与购买相关的所有密钥。

​
主要好处

  • 降低支持量：客户自行解决常见的账单请求。
  • 更快的价值实现：立即访问发票和密钥。
  • 降低流失风险：清晰可见的续订和计划详情。
  • 安全设计：使用过期链接的令牌化访问。

​
访问方式

客户可以通过静态链接或一次性动态链接访问门户。

​
静态链接（基于电子邮件的访问）

客户可以通过在一个永不过期的静态链接中输入他们的电子邮件来请求门户访问。 静态门户链接格式因环境而异： 测试模式（用于测试和开发）： 
https://test.customer.dodopayments.com/login/{business_id}
实时模式（用于真实交易的生产环境）： 
https://customer.dodopayments.com/login/{business_id}
将 {business_id} 替换为您的实际业务标识符，然后与客户分享相应链接，以便他们输入电子邮件并获取安全的门户访问权限。
基于电子邮件的登录界面
1

Merchant flow

  1. 转到 Sales → Customer。
  2. 点击 Share invite。
  3. 复制 Static link 并与客户分享。
2

Customer flow

  1. 打开该静态链接。
  2. 输入购买时使用的电子邮件。
  3. 收到一个安全的登录链接以访问门户。
现有客户会被自动识别。

​
动态链接（魔法链接）

一个个性化的一次性魔法链接，直接将客户引导到门户。该链接在24小时内过期。
动态链接在 24 小时后过期。如过期，请生成并发送新链接。
魔术链接直接访问
1

Merchant flow

  1. 转到 Sales → Customer。
  2. 点击 Share invite。
  3. 复制 Dynamic link 并与客户分享。
2

Customer flow

  1. 打开该动态链接。
  2. 直接访问客户门户，无需输入电子邮件。

​
门户功能

改版后的客户门户提供了简洁统一的界面，带有左侧边栏，并为所有账户管理需求组织了各个版块。

Active Subscriptions

查看所有激活订阅，其包含计划名称、价格、续订日期和有效期。点击“Manage subscription”可查看详情、编辑账单信息或取消。

Payment Methods

一目了然地查看所有保存的支付方式（卡、UPI 等）。可以直接在订阅详情中编辑支付方式。

Billing History

在详细表格中查看所有交易，含日期、状态、定价类型、权益以及可下载的发票。

Billing Information

在订阅详情页查看并编辑姓名、电子邮件、电话号码及账单地址。

​
门户概览

门户主页在一个可滚动视图中展示所有激活订阅、保存的支付方式和账单历史。
客户门户主页，展示活跃订阅和支付方式

​
支付方式与账单历史

向下滚动可查看保存的支付方式和含状态指示及可下载发票的完整账单历史。
显示支付方式和账单历史，支持下载发票

​
计划变更（升级/降级）

当产品被归类到 产品集合 中时，客户可以直接在客户门户内在计划之间升级或降级。
想为现有订阅启用升级/降级？ 将您的订阅产品添加到产品集合。一旦归组，客户即可通过客户门户在同一集合内的计划之间切换。

​
可用操作

操作描述何时可用
Upgrade在同一集合内切换至更高等级计划企业已启用订阅更新
Downgrade在同一集合内切换至更低等级计划企业已启用订阅更新

​
计划变更的工作原理

  1. 客户在门户中查看当前订阅
  2. 根据产品集合显示可用的升级/降级选项
  3. 客户选择新计划
  4. 按比例分摊会被计算并（如适用）立即处理付款
  5. 订阅被更新至新计划
计划变更仅在同一集合内的产品之间可用。产品必须是订阅或基于使用量计费类型。

​
企业控制

企业可在订阅设置中配置计划变更行为：
  • Allow Subscription Updates：启用或禁用客户升级或降级其订阅的能力

Product Collections

了解如何设置产品集合并配置升级/降级路径。

​
订阅详情

当客户在任意活跃订阅上点击“Manage subscription”时，他们会进入订阅详情页面。该页面显示：
  • Plan details：订阅名称、价格、续订日期以及有效期
  • Payment method：连接到订阅的卡或支付方式，附有“Edit”按钮
  • Billing information：姓名、电子邮件、电话号码和账单地址，附有“Edit”按钮
  • Billing history：该订阅所有付款的详细表格
  • Cancel Subscription：一个显眼的按钮，用于取消订阅
订阅详情页，展示计划信息、支付方式、账单信息和取消选项

​
取消订阅

客户可以直接在订阅详情页取消订阅。点击“Cancel Subscription”会打开一个确认对话框，提供两个选项：
  • Cancel at next billing date：订阅在当前计费期结束后自动取消。
  • Cancel now：订阅立即取消。
带有下一个计费日取消或立即取消选项的取消订阅对话框

​
更新支付方式

客户可以通过点击支付方式旁的“Edit”按钮，在订阅详情页直接更新支付方式。此功能对于因付款失败而被暂停的订阅的重新激活尤为重要。

​
重新激活被暂停的订阅

当订阅因付款失败而被置于 on_hold 状态时，客户必须更新支付方式以重新激活。更新流程会自动：
  1. Creates a charge 用于结清剩余欠款
  2. Generates an invoice 用于该费用
  3. Processes the payment 使用新支付方式处理付款
  4. Reactivates the subscription，在付款成功后将其恢复至 active 状态
处于 on_hold 状态的订阅不会自动续订。客户必须更新支付方式以清除欠款并重新激活订阅。
在成功更新 on_hold 订阅的支付方式后，客户将看到确认页面，并收到有关支付成功及订阅重新激活的电子邮件通知。

​
支付方式更新流程

1

Access subscription details

在门户主页上点击任意活跃订阅的“Manage subscription”。
2

Click Edit on payment method

点击支付方式旁的“Edit”按钮以打开支付方式更新界面。
3

Select or add payment method

选择一个已保存的支付方式或通过安全输入卡信息添加新方式。
4

Confirm changes

确认更新。对于 on_hold 订阅，此操作会自动为剩余欠款创建费用。
5

Complete payment (if on hold)

若订阅处于暂停状态，客户将被重定向以完成剩余欠款的支付。付款成功后，订阅会被自动重新激活。
6

Confirmation

客户会收到支付方式已更新以及（如适用）订阅已重新激活的确认信息。

​
集成示例

通过 API 为特定客户创建一个有时限的客户门户会话，然后将用户重定向到该会话 URL。 
const session = await client.customers.customerPortal.create('cus_123');

// Redirect the user to the hosted Customer Portal
window.location.href = session.link;

​
统一客户门户

除以企业为准的客户门户外，Dodo Payments 还提供一个 统一客户门户，网址为 customer.dodopayments.com，客户可以在此查看并管理所有通过 Dodo Payments 完成的不同企业的购买与订阅。
统一客户门户

​
统一门户功能

  • Cross-business visibility：在一个位置查看任何 Dodo Payments 商户的所有购买和订阅
  • Centralized management：在单一仪表板中管理多个企业的订阅
  • Unified billing history：获取所有购买的发票和支付记录
  • Single sign-on：使用电子邮件登录一次即可访问所有 Dodo Payments 商户的购买记录
统一客户门户可与企业专属门户互补。客户可根据偏好使用品牌商户门户或统一门户。

​
故障排除

  • Link expired：生成并发送新的动态链接。
  • Email not recognized：请客户使用与购买相关联的电子邮件。
  • Subscription on hold：若订阅被暂停，客户必须通过门户更新支付方式以清除欠款并重新激活订阅。更新过程会自动为剩余欠款收费。
  • Payment method update failed：若在 on_hold 订阅的更新过程中付款失败，订阅将继续保持暂停状态。客户可尝试使用其他支付方式再试一次。

Design & Theme Customization

可从“设计”页面使用预建主题、排版、颜色和实时预览自定义客户门户外观。