Skip to main content
Customer Portal API 是 Waffo 的 customer 侧接口。商户后端通过 Issue Session Token mint 短期 session token，由 customer 浏览器（或你的产品内 UI）在 Authorization 头中携带调用下列端点。商户 API Key 永不离开服务端。
Session token 按 buyerIdentity + visitingStoreId 限制作用域，只能操作属于该 customer 在该门店内的记录。不能读取商户全量数据。

​
每次调用必须的请求头

网关从 token 派生 customer identity 与 visiting store，无需作为独立请求头传入。

​
端点

取消一次性订单

在支付完成前取消待处理的一次性订单

取消订阅

代 customer 取消活跃或待处理的订阅

恢复订阅

在 canceling 期间撤销待生效的取消

更换产品

将活跃订阅切换到另一个产品

GraphQL

查询 customer 自己的订单、支付、退款

​
Token 路径特有错误

仅在 session-token 调用路径下出现的错误：