客户门户

​

什么是客户门户？

• 访问账单历史记录：查看发票并下载收据。
• 管理订阅：查看订阅详情，暂停和恢复订阅，并立即或在下一个账单日期取消订阅。
• 更新支付方式：更改有效订阅的支付方式，或重新激活处于暂停状态的订阅。
• 获取许可证密钥：访问与购买相关联的所有密钥。
• 轻松导航：使用返回按钮在门户的各个部分之间切换，同时不会丢失上下文。

​

主要好处

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

​

访问方式

​

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

https://test.customer.dodopayments.com/login/{business_id}

https://customer.dodopayments.com/login/{business_id}

​

动态链接（魔法链接）

​

门户功能

​

门户概览

​

支付方式与账单历史

​

计划变更（升级/降级）

• 自动检测：首次访问时，门户会根据客户的浏览器设置检测其首选语言，并加载相应的翻译（如果有）。默认情况下使用英语。
• 手动覆盖：客户可以随时通过门户标题中的语言选择器更改活动语言（适用于电脑和移动设备）。
• 持久偏好：所选语言将存储在 NEXT_LOCALE cookie 中（有效期为1年），以便在会话之间记住选择。

​

计划变更的工作原理

1. 客户在门户中查看当前订阅
2. 根据产品集合显示可用的升级/降级选项
3. 客户选择新计划
4. 按比例分摊会被计算并（如适用）立即处理付款
5. 订阅被更新至新计划

​

企业控制

• Allow Subscription Updates：启用或禁用客户升级或降级其订阅的能力

1. 客户在订阅详情页面点击 Change Plan。
2. 系统根据产品集合显示可用的升级/降级选项。
3. 客户选择新方案。Confirm Plan Change 面板会显示当前方案与更新后的方案、订单项明细（旧方案的抵扣、新方案的费用）、税费以及当前应付金额。客户也可以在此处添加折扣代码。
4. 客户点击 Pay ${amount} 确认。
5. 系统计算按比例计费金额并处理费用——费用会从已保存的支付方式中扣除；如果商家通过 payment link 收取方案变更费用，则会跳转到托管结账页面（见下文）。
6. 订阅更新为新方案。更新是立即生效，还是仅在费用支付成功后生效，取决于您的 payment failure handling；通过 payment link 支付的方案变更始终需要等待支付完成。

​

通过 Payment Link 收取方案变更费用

​

商家控制项

• Allow Subscription Updates：启用或禁用客户升级或降级订阅的功能
• Allow Subscription Cancellation：启用或禁用客户取消自己订阅的功能
• Allow Subscription Pause：启用或禁用客户暂停和恢复自己订阅的功能
• Collect Plan Change Payments by Payment Link：将客户发送到 checkout 页面，为立即方案变更付款，而不是从其已保存的支付方式中扣款。默认关闭。

​

订阅详情

• 方案详情：订阅名称、价格、续订日期和有效期
• 支付方式：与订阅关联的卡片或支付方式，以及“Edit”按钮
• 账单信息：姓名、电子邮件、电话号码和账单地址，以及“Edit”按钮
• 账单历史：此订阅的所有支付记录的详细表格
• 暂停：暂停订阅的选项，仅在您允许自助暂停时显示
• Cancel Subscription：用于取消订阅的醒目按钮

​

取消订阅

• 在下一个计费日期取消：订阅会保持有效，直到当前计费周期结束，然后自动取消。
• 立即取消：订阅会立即取消。

​

取消原因

// Read the captured feedback after a customer cancels
const subscription = await client.subscriptions.retrieve('sub_123');
console.log(subscription.cancellation_feedback); // e.g., "too_expensive"
console.log(subscription.cancellation_comment);  // e.g., "Switching to a competitor"

​

暂停订阅

• 访问权限会立即停止。 订阅包含的功能、下载内容和许可证密钥会停止工作，直到订阅恢复。
• 暂停没有结束日期。 订阅会一直处于暂停状态，直到客户恢复订阅。
• 不会损失时间。 下一个计费日期和续订日期都会按照暂停时长向后顺延。

​

更新支付方式

​

重新激活处于暂停状态的订阅

1. 创建一笔费用，用于支付剩余应付款项
2. 生成 invoice，用于记录该费用
3. 处理支付，使用新的支付方式完成
4. 重新激活订阅，支付成功后将订阅恢复为 active 状态

​

支付方式更新流程

​

集成示例

const session = await client.customers.customerPortal.create('cus_123');

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

​

统一 Customer Portal

​

统一 Portal 功能

• 跨商家可见性：在一个位置查看任何 Dodo Payments 商家的所有购买记录和订阅
• 集中管理：从单一 dashboard 管理不同商家的订阅
• 统一账单历史：访问所有购买记录的 invoice 和支付历史
• 单点登录：使用电子邮件登录一次，即可访问所有 Dodo Payments 商家的购买记录

​

故障排查

• 链接已过期：生成并发送新的动态链接。
• 未识别电子邮件：请客户使用与其购买记录关联的电子邮件
• 订阅处于暂停状态：如果订阅处于暂停状态，客户必须通过 Portal 更新支付方式，以结清欠款并重新激活订阅。更新流程会自动收取剩余应付款项。
• 支付方式更新失败：如果 on_hold 订阅在更新过程中支付失败，订阅将继续处于暂停状态。客户可以使用其他支付方式重试。