客户门户

​

什么是客户门户？

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

​

主要好处

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

​

访问方式

​

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

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：启用或禁用客户升级或降级其订阅的能力

​

订阅详情

• Plan details：订阅名称、价格、续订日期以及有效期
• Payment method：连接到订阅的卡或支付方式，附有“Edit”按钮
• Billing information：姓名、电子邮件、电话号码和账单地址，附有“Edit”按钮
• Billing history：该订阅所有付款的详细表格
• Cancel Subscription：一个显眼的按钮，用于取消订阅

• 允许更新订阅：启用或禁用客户升级或降级其订阅的功能
• 允许取消订阅：启用或禁用客户取消其订阅的功能
• 允许暂停订阅：启用或禁用客户暂停和恢复其订阅的功能

• Cancel at next billing date：订阅在当前计费期结束后自动取消。
• Cancel now：订阅立即取消。

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

​

重新激活被暂停的订阅

1. Creates a charge 用于结清剩余欠款
2. Generates an invoice 用于该费用
3. Processes the payment 使用新支付方式处理付款
4. Reactivates the subscription，在付款成功后将其恢复至 active 状态

​

取消原因

// 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. 为扣款生成发票
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;

​

Unified Customer Portal

​

Unified Portal 功能

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

​

故障排除

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