客户门户

​

什么是 Customer Portal？

• 访问账单历史记录：查看过往付款并下载发票。
• 管理订阅：查看订阅详情、暂停和恢复订阅，并根据您的设置立即取消或在下一个账单日期取消订阅。
• 更新付款方式：更改订阅的付款方式，或重新激活处于暂停状态的订阅。
• 获取许可证密钥：查看与其购买记录关联的许可证密钥。
• 返回您的应用：当您传入 return_url 时，门户会显示返回您企业的链接。在移动设备上，页眉中的返回箭头会返回门户概览。

​

主要优势

• 减少支持请求量：客户可以自行处理常见的账单请求。
• 更快获取信息：客户登录后即可获取发票和许可证密钥。
• 降低流失风险：客户可以在扣款前查看续订日期和方案详情。
• 签名且会过期的链接：每个登录链接都会进行签名，并在 24 小时后过期。
• 本地化体验：门户支持 21 种语言，并根据客户的浏览器设置选择语言。

​

访问方式

​

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

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

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

​

动态链接（Magic Link）

​

门户功能

​

门户概览

​

支付方式和账单历史记录

​

语言支持

​

语言选择方式

• 自动检测：首次访问时，门户会读取浏览器中的首选语言；如果支持该语言，就会加载该语言，否则使用英语。
• 手动覆盖：客户可以随时使用页面右下角的语言选择器更改语言，桌面设备和移动设备均支持此功能。
• 保存偏好设置：门户会将语言选择保存在 NEXT_LOCALE cookie 中一年，因此会在不同访问期间记住该语言。

​

支持的语言

​

更改套餐（升级/降级）

​

可用操作

​

套餐更改的工作方式

1. 客户在订阅详情页点击变更方案。
2. 门户会列出产品集合中的其他方案。
3. 客户选择一个方案。确认方案变更面板会显示当前方案和更新后的方案、明细项分解（旧方案的抵扣额和新方案的收费额）、税费以及当前应付金额。客户也可以在此输入折扣码。
4. 客户点击显示应付金额的付款按钮进行确认。
5. Dodo Payments 会计算按比例计费金额并收取费用，可以从已保存的付款方式扣款；如果您通过付款链接收取方案变更费用，则会打开托管结账页面（请参阅通过付款链接收取方案变更费用）。
6. 订阅会切换到新方案。该变更是立即生效，还是仅在收费成功后生效，取决于您的付款失败处理方式。通过付款链接支付的方案变更始终要等到付款完成后才会生效。

​

通过支付链接收取套餐更改费用

​

企业控制项

• 允许更新订阅：允许客户升级或降级。默认关闭。
• 允许立即取消：允许客户立即结束订阅并失去访问权限。默认开启。
• 允许在下一个账单日期取消：允许客户在已付费周期结束时取消订阅。默认开启。
• 允许暂停订阅：允许客户自行暂停和恢复订阅。默认关闭。
• 通过付款链接收取方案变更费用：将客户发送到结账页面，以支付立即变更方案的费用，而不是从其已保存的付款方式扣款。默认关闭。

​

订阅详情

• 方案详情：订阅名称、价格、续订日期和有效期。
• 付款方式：订阅使用的付款方式，以及编辑按钮。
• 账单信息：姓名、电子邮件、电话号码和账单地址，以及用于编辑姓名和账单地址的编辑按钮。
• 账单历史记录：该订阅的所有付款表格。
• 暂停订阅：在允许自助暂停时显示。
• 取消订阅：打开取消对话框。

​

取消订阅

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

​

取消原因

// `client` is a DodoPayments client, created as in the Integration Guide.
// 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

​

重新激活处于宽限期的订阅

​

支付方式更新流程

​

集成示例

// Server: `client` is a DodoPayments client, created as in the Integration Guide.
const session = await client.customers.customerPortal.create('cus_123', {
  return_url: 'https://yourapp.com/account', // optional: shown as a back link in the portal
});

// Send session.link to the browser, then redirect the customer:
// window.location.href = session.link;

​

Unified Customer Portal

​

Unified Portal 功能

• 跨企业可见性：在一个位置查看每个 Dodo Payments 商家的购买记录和订阅。
• 集中管理：在一个网站中管理不同企业的订阅。
• 统一账单历史记录：访问所有购买记录的发票和付款历史记录。
• 单次登录：使用电子邮件地址登录一次，即可访问所有 Dodo Payments 商家的购买记录。

​

故障排除

• 链接已过期：生成新的动态链接并发送给客户。
• 无法识别电子邮件：请客户使用购买时所用的电子邮件地址。对于不属于您企业客户的地址，不会发送登录电子邮件。
• 订阅处于暂停状态：客户在门户中更新付款方式。付款成功后，Dodo Payments 会收取剩余应付款并重新激活订阅。
• 付款方式更新失败：如果更新 on_hold 订阅时付款失败，订阅会保持暂停状态。客户可以使用其他付款方式重试。