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啟用新建立嘅用戶帳戶,並設定第一個密碼——透過邀請電郵嘅連結啟動。