POST/api/public/access-request/stripe/create-checkout
为所选套餐创建一个 Stripe 结账会话。
将套餐代码发送到 `package` 字段,可选发送申请人的 `email`,以及在 `payment_method_types` 中指定所需的支付方式(默认:信用卡;若已启用则可用 SEPA 直接扣款)。成功时,响应的 `data` 对象包含 `session_id` 以及您将买方重定向到的 Stripe 结账页面的 `url`。金额仅在服务器端确定。 无效套餐会导致 400 `INVALID_PACKAGE`。若 Stripe 当前不可用,端点会以 503 `STRIPE_NOT_READY` 响应。该端点限制为每个 IP 地址最多 15 分钟内 10 次请求。每次成功调用都会创建一个新会话,请不要自动重试。
概览
调用:POST /api/public/access-request/stripe/create-checkout。该端点属于 Zentor App API 的“公开表单”分组。 该端点可公开访问,无需身份验证。 该调用不是幂等的:每次成功调用都会再次触发该操作。 必填参数:package (请求体)。 已记录的错误情况:503 STRIPE_NOT_READY。 下方的示例响应展示了 JSON 格式的成功响应结构。
身份验证与安全
无需身份验证
幂等: 否
参数
package(body, string,必填)— 所选套餐的套餐代码请求示例
{"package":"starter"}响应示例
{"ok":false,"error":"STRIPE_NOT_READY","message":"Stripe-Zahlung ist momentan nicht verfügbar."}错误代码
503 STRIPE_NOT_READY — Stripe 当前不可用。已验证的行为
若没有可用的 Stripe 对接,该调用返回 503 `STRIPE_NOT_READY`。成功情况需要通过 Stripe 完成真实付款。
公开表单
POST /api/public/contact接收来自 Zentor App 网站联系表单的请求,并转发给 Zentor 团队。POST /api/public/consultation接收来自 Zentor App 网站表单的咨询请求。POST /api/public/access-request提交某个套餐(Starter、个性化或 14 天 Demo)的访问申请。前提条件是事先已确认的电子邮件地址。POST /api/public/access-request/email/start-verification向指定的电子邮件地址发送一个有效期为 10 分钟的六位数确认码——这是访问申请的第一步。POST /api/public/access-request/email/verify校验邮件中发送的代码,并为后续的访问申请发出确认令牌。GET /api/public/access-request/payment-status指示当前访问申请可使用哪些支付方式(PayPal、Stripe)。GET /api/public/access-request/paypal/config返回支付步骤所需的公开 PayPal 配置(启用状态、模式、货币)。POST /api/public/access-request/paypal/create-order为所选套餐创建一个 PayPal 订单。POST /api/public/access-request/paypal/capture-order完成(捕获)之前创建并由买方在 PayPal 结账页面批准的订单。金额仅由服务器确定。POST /api/public/activate-account激活新创建的用户账户并设置首个密码——通过邀请邮件中的链接触发。