POST/api/public/access-request/paypal/capture-order
ดำเนินการให้เสร็จสิ้น (capture) คำสั่งซื้อที่สร้างไว้ก่อนหน้าและได้รับการอนุมัติจากผู้ซื้อในหน้าชำระเงินของ PayPal จำนวนเงินกำหนดโดยเซิร์ฟเวอร์เท่านั้น
หลังจากผู้ซื้ออนุมัติการชำระเงินที่ PayPal แล้ว ส่ง Order ID ที่ได้จาก `paypal/create-order` ในช่อง `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 เอนด์พอยต์นี้อยู่ในกลุ่ม “ฟอร์มสาธารณะ” ของ API ของ Zentor App เอนด์พอยต์นี้เข้าถึงได้แบบสาธารณะและไม่ต้องยืนยันตัวตน การเรียกใช้นี้ไม่เป็นแบบ idempotent: การเรียกที่สำเร็จแต่ละครั้งจะทริกเกอร์การดำเนินการใหม่อีกครั้ง พารามิเตอร์ที่จำเป็น: order_id (body) กรณีข้อผิดพลาดที่จัดทำเอกสารไว้: 400 ORDER_ID_REQUIRED, 404 UNKNOWN_ORDER, 409 CAPTURE_NOT_COMPLETED, 502 PAYPAL_CAPTURE_FAILED ตัวอย่างการตอบกลับด้านล่างแสดงโครงสร้างของการตอบกลับที่สำเร็จในรูปแบบ JSON
การยืนยันตัวตนและความปลอดภัย
ไม่ต้องยืนยันตัวตน
สูงสุด 10 คำขอต่อ 15 นาทีต่อที่อยู่ IP
Idempotent (เรียกซ้ำได้ผลเหมือนเดิม): ไม่
พารามิเตอร์
order_id(body, string, จำเป็น)— PayPal Order ID ที่ได้จาก `paypal/create-order`ตัวอย่างคำขอ
{"order_id":"<PAYPAL_ORDER_ID>"}ตัวอย่างการตอบกลับ
{"ok":false,"error":"UNKNOWN_ORDER","message":"ไม่รู้จักคำสั่งซื้อนี้"}รหัสข้อผิดพลาด
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 และส่งต่อให้ทีม ZentorPOST /api/public/consultationรับคำขอรับคำปรึกษาจากฟอร์มของเว็บไซต์ Zentor AppPOST /api/public/access-requestส่งคำขอเข้าถึงสำหรับแพ็กเกจ (Starter, แบบกำหนดเอง หรือ Demo 14 วัน) เงื่อนไขก่อนคือต้องมีอีเมลที่ยืนยันไว้ก่อนแล้วPOST /api/public/access-request/email/start-verificationส่งโค้ดยืนยัน 6 หลักที่มีอายุ 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เปิดใช้งานบัญชีผู้ใช้ที่สร้างขึ้นใหม่และตั้งรหัสผ่านแรก – เริ่มต้นจากลิงก์ในอีเมลคำเชิญ