POST/api/public/access-request/paypal/capture-order
捕获(最终扣款)一笔此前已创建、并已由买家在 PayPal 结账中批准的订单。以服务端为准——客户端无法影响金额。
身份验证与安全
无需身份验证
strictLimiter(10 次请求/15 分钟,绑定 IP)。
幂等: 否
参数
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 通信错误。实时测试证明
两个失败场景均已在未配置 PayPal 的情况下实时验证(400 ORDER_ID_REQUIRED、404 UNKNOWN_ORDER)。真实的成功场景需要包含买家批准的实际 PayPal 沙箱支付流程,根据测试要求已排除(不调用真实支付服务商)。