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

创建门户会话 (API)

以编程方式创建安全的、时间限制的门户会话。

订阅

管理定期计划、升级、降级和附加服务。

客户门户概述封面

​
什么是客户门户？

该门户为客户提供了一个可信的、品牌化的自助服务体验，客户可以：
  • 访问账单历史：查看和下载发票。
  • 管理订阅：取消订阅。
  • 更新支付方式：更改活动订阅的支付方式或重新激活暂停的订阅。
  • 检索许可证密钥：访问与购买相关的所有密钥。

​
主要好处

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

​
访问方式

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

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

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

商家流程

  1. 转到销售 → 客户。
  2. 点击 分享邀请。
  3. 复制 静态链接 并与您的客户分享。
2

客户流程

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

​
动态链接（魔法链接）

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

商家流程

  1. 转到销售 → 客户。
  2. 点击 分享邀请。
  3. 复制 动态链接 并与您的客户分享。
2

客户流程

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

​
门户功能

账单历史

查看所有交易和发票详细信息。从您的帐户下载每张发票的PDF。

订阅

查看活动和过去的订阅，包括续订日期。随时取消任何计划。

支付方式

更新订阅的支付方式。通过更新支付方式以清除欠款来重新激活暂停的订阅。

个人资料

直接在个人资料设置中查看或更新您的姓名、电子邮件和电话号码。

​
更新支付方式

客户可以直接从客户门户更新他们的支付方式。此功能对于重新激活因支付失败而暂停的订阅尤为重要。

​
查看当前支付方式

在订阅管理页面，客户可以看到当前支付方式与订阅详细信息一起显示。支付方式部分显示卡类型、后四位数字和一个“编辑”按钮以进行更新。
显示当前支付方式和编辑选项的订阅详细信息页面

​
更新支付方式

当客户点击支付方式部分的“编辑”时，他们可以：
  1. 选择现有支付方式：从之前保存的支付方式中选择

    显示已保存支付方式的编辑支付方式模态

  2. 添加新支付方式：安全地输入新卡详细信息

    带有卡输入字段的支付方式更新表单

​
重新激活暂停的订阅

当订阅因支付失败而处于 on_hold 状态时，客户必须更新他们的支付方式以重新激活它。更新过程会自动：
  1. 创建一笔费用以支付剩余欠款
  2. 生成一张发票以支付费用
  3. 使用新支付方式处理付款
  4. 在成功付款后将订阅重新激活为 active 状态
处于 on_hold 状态的订阅将不会自动续订。客户必须更新他们的支付方式以清除欠款并重新激活订阅。
在成功更新 on_hold 订阅的支付方式后，客户将看到确认页面并收到有关成功付款和订阅重新激活的电子邮件通知。
确认支付方式更新和订阅重新激活的支付成功页面

​
支付方式更新流程

1

访问订阅详细信息

在客户门户中导航到订阅管理页面以查看订阅详细信息和当前支付方式。
2

点击支付方式上的编辑

点击支付方式部分旁边的“编辑”按钮以打开支付方式更新界面。
3

选择或添加支付方式

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

确认更改

点击“确认更改”以更新支付方式。对于 on_hold 订阅，这将自动创建一笔费用以支付剩余欠款。
5

完成支付（如果处于暂停状态）

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

确认

客户会收到确认，表示支付方式已更新，并且（如适用）订阅已重新激活。

​
集成示例

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

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

​
故障排除

  • 链接过期：生成并发送新的动态链接。
  • 电子邮件未识别：请客户使用与其购买相关的电子邮件。
  • 订阅处于暂停状态：如果订阅处于暂停状态，客户必须通过门户更新其支付方式以清除欠款并重新激活订阅。更新过程将自动收取剩余欠款。
  • 支付方式更新失败：如果在 on_hold 订阅的更新过程中支付失败，订阅将保持暂停状态。客户可以尝试使用不同的支付方式。