> ## Documentation Index
> Fetch the complete documentation index at: https://docs.waffo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 客户门户

> 供消费者管理订单和订阅的自助服务门户

客户门户为您的消费者提供一个自助服务界面，他们可以在其中管理自己的购买、查看发票、更新账单信息以及管理订阅 — 无需密码。

消费者通过 **Magic Link** 登录 — 输入邮箱后会收到一个登录链接，点击即可进入门户。

<Card title="消费者门户" icon="arrow-up-right-from-square" href="https://pancake.waffo.ai/consumer/portal/login">
  登录消费者门户以查看订单、管理订阅并下载发票。
</Card>

***

## 客户可以在客户门户中做什么？

<CardGroup cols={2}>
  <Card title="订阅管理" icon="repeat">
    查看有效订阅和下次扣款日期，变更方案，取消或重新激活订阅。
  </Card>

  <Card title="订单与支付" icon="credit-card">
    浏览所有历史订单和付款记录，并查看状态详情。
  </Card>

  <Card title="发票下载" icon="file-invoice">
    下载 16 种语言的 PDF 发票和收据，包含完整的账单信息。
  </Card>

  <Card title="账单信息" icon="pen-to-square">
    更新账单地址，并添加用于开票的企业名称和税号。
  </Card>
</CardGroup>

***

## 取消原因反馈

取消弹窗会询问客户离开的原因。

| | |
| - | - |
| **选填** | 永远不会阻断取消动作 |
| **Other** | 展开一个自由填写的备注框 |
| **跳过** | 记录为 `not_provided`，而不是被忽略 |
| **留存** | 每次成功取消留存一行记录 |

由于门户一定会问，跳过与「根本不展示该问题的集成」有本质区别 —— 记录下来才能让「拒答」的占比可读。

<Card title="取消原因留存规则" icon="code" href="/zh/api-reference/endpoints/subscriptions/cancel-subscription-customer">
  `cancelReason` / `cancelComment` 的字段约定，以及如何通过 GraphQL 读取原因。
</Card>

***

## 门户访问

统一的消费者门户地址：

```
https://pancake.waffo.ai/consumer/portal/login
```

消费者在登录页输入购买时使用的邮箱，收到一次性 Magic Link，点击即可进入门户。无需密码。

### 从你自己的网站跳转到门户

你可以在自己的网站上放一个「管理订阅」链接，指向上面的地址。消费者仍需用购买时的邮箱登录 —— 目前**没有为指定消费者生成免登录门户链接的 API**，所以这一跳无法跳过 Magic Link 步骤。用服务端签发免登录门户链接的接口已在规划中。

如果希望消费者不离开你的站点，可以使用 [Customer Portal API](/zh/api-reference/endpoints/auth/customer-endpoints)：先获取消费者 session token，再在自己的页面里调用取消、恢复订阅和账单信息等端点。

***

## 无法登录？

<AccordionGroup>
  <Accordion title="没有收到登录邮件？">
    1. 请确认使用的是原始购买时填写的邮箱地址（可查阅订单收据邮件）
    2. 检查垃圾邮件文件夹，发件人为 `auth@waffo.ai`
    3. 返回登录页面并重新申请一封 Magic Link
  </Accordion>

  <Accordion title="仍然无法登录？">
    请发送邮件至 `support@waffo.ai`，附上您的购买邮箱和订单详情，我们会协助处理。
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.