POST/api/public/access-request/paypal/capture-order
完成(捕获)之前创建并由买方在 PayPal 结账页面批准的订单。金额仅由服务器确定。
买方在 PayPal 批准付款后,将 `paypal/create-order` 返回的订单 ID 发送到 `order_id` 字段。成功时付款完成,访问申请将继续处理。 错误情况:400 `ORDER_ID_REQUIRED`(字段缺失)、404 `UNKNOWN_ORDER`(非已知订单)、409 `CAPTURE_NOT_COMPLETED`(付款尚未批准——买方必须完成 PayPal 结账)以及 502 `PAYPAL_CAPTURE_FAILED`(与 PayPal 通信出错)。每个订单只应调用此端点一次。
概览
调用:POST /api/public/access-request/paypal/capture-order。该端点属于 Zentor App API 的“公开表单”分组。 该端点可公开访问,无需身份验证。 该调用不是幂等的:每次成功调用都会再次触发该操作。 必填参数:order_id (请求体)。 已记录的错误情况:400 ORDER_ID_REQUIRED, 404 UNKNOWN_ORDER, 409 CAPTURE_NOT_COMPLETED, 502 PAYPAL_CAPTURE_FAILED。 下方的示例响应展示了 JSON 格式的成功响应结构。
身份验证与安全
无需身份验证
每个 IP 地址最多 15 分钟内 10 次请求。
幂等: 否
参数
order_id(body, string,必填)— 由 `paypal/create-order` 返回的 PayPal 订单 ID请求示例
{"order_id":"<PAYPAL_ORDER_ID>"}响应示例
{"ok":false,"error":"UNKNOWN_ORDER","message":"Unbekannte Bestellung."}错误代码
400 ORDER_ID_REQUIRED — `order_id` 字段缺失。404 UNKNOWN_ORDER — `order_id` 不是已知的、此前创建的订单。409 CAPTURE_NOT_COMPLETED — 买方尚未批准支付。502 PAYPAL_CAPTURE_FAILED — 与 PayPal 通信时发生错误。已验证的行为
缺失 `order_id` 返回 400 `ORDER_ID_REQUIRED`,未知订单返回 404 `UNKNOWN_ORDER`。成功情况需要买方批准的真实 PayPal 付款。
公开表单
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/stripe/create-checkout为所选套餐创建一个 Stripe 结账会话。POST /api/public/activate-account激活新创建的用户账户并设置首个密码——通过邀请邮件中的链接触发。