POST/api/public/access-request/paypal/capture-order

Hoàn tất (capture) một đơn hàng đã được tạo trước đó và được người mua phê duyệt tại checkout PayPal. Số tiền chỉ do server xác định.

Sau khi người mua phê duyệt thanh toán tại PayPal, gửi order ID trả về từ `paypal/create-order` trong trường `order_id`. Khi thành công, thanh toán hoàn tất và yêu cầu truy cập được xử lý tiếp. Các trường hợp lỗi: 400 `ORDER_ID_REQUIRED` (thiếu trường), 404 `UNKNOWN_ORDER` (không phải đơn hàng đã biết), 409 `CAPTURE_NOT_COMPLETED` (thanh toán chưa được phê duyệt – người mua phải hoàn tất checkout PayPal) và 502 `PAYPAL_CAPTURE_FAILED` (lỗi giao tiếp với PayPal). Chỉ gọi endpoint này một lần cho mỗi đơn hàng.

Tổng quan

Lệnh gọi: POST /api/public/access-request/paypal/capture-order. Endpoint này thuộc nhóm “Biểu mẫu công khai” trong API của Zentor App. Endpoint này được truy cập công khai và không yêu cầu xác thực. Lệnh gọi không có tính idempotent: mỗi lệnh gọi thành công đều kích hoạt lại hành động. Tham số bắt buộc: order_id (body). Các trường hợp lỗi được tài liệu hóa: 400 ORDER_ID_REQUIRED, 404 UNKNOWN_ORDER, 409 CAPTURE_NOT_COMPLETED, 502 PAYPAL_CAPTURE_FAILED. Phản hồi mẫu bên dưới cho thấy cấu trúc của một phản hồi thành công ở định dạng JSON.

Xác thực & bảo mật

Không cần xác thực

Tối đa 10 yêu cầu mỗi 15 phút cho mỗi địa chỉ IP.

Lũy đẳng (idempotent): Không

Tham số

order_id(body, string, bắt buộc)— PayPal order ID trả về từ `paypal/create-order`

Request mẫu

{"order_id":"<PAYPAL_ORDER_ID>"}

Response mẫu

{"ok":false,"error":"UNKNOWN_ORDER","message":"Đơn hàng chưa xác định."}

Mã lỗi

400 ORDER_ID_REQUIRED — Trường `order_id` bị thiếu.
404 UNKNOWN_ORDER — `order_id` không phải là một đơn hàng đã biết, được tạo trước đó.
409 CAPTURE_NOT_COMPLETED — Người mua chưa phê duyệt thanh toán.
502 PAYPAL_CAPTURE_FAILED — Đã xảy ra lỗi khi giao tiếp với PayPal.

Hành vi đã được xác minh

Thiếu `order_id` trả về 400 `ORDER_ID_REQUIRED`, đơn hàng không xác định trả về 404 `UNKNOWN_ORDER`. Trường hợp thành công yêu cầu một khoản thanh toán PayPal thực đã được người mua phê duyệt.

Biểu mẫu công khai

POST /api/public/contactNhận yêu cầu từ biểu mẫu liên hệ trên website Zentor App và chuyển tiếp cho đội ngũ Zentor.POST /api/public/consultationNhận yêu cầu tư vấn từ biểu mẫu trên website Zentor App.POST /api/public/access-requestGửi yêu cầu truy cập cho một gói (Starter, Cá nhân hóa hoặc Demo 14 ngày). Điều kiện là địa chỉ email đã được xác nhận trước đó.POST /api/public/access-request/email/start-verificationGửi mã xác nhận sáu chữ số có hiệu lực 10 phút đến địa chỉ email đã cho – bước đầu tiên của yêu cầu truy cập.POST /api/public/access-request/email/verifyKiểm tra mã được gửi qua email và cấp một token xác nhận cho yêu cầu truy cập tiếp theo.GET /api/public/access-request/payment-statusCho biết những phương thức thanh toán nào (PayPal, Stripe) hiện khả dụng cho yêu cầu truy cập.GET /api/public/access-request/paypal/configTrả về cấu hình PayPal công khai (kích hoạt, chế độ, loại tiền) cho bước thanh toán.POST /api/public/access-request/paypal/create-orderTạo một đơn hàng PayPal cho gói đã chọn.POST /api/public/access-request/stripe/create-checkoutTạo một session checkout Stripe cho gói đã chọn.POST /api/public/activate-accountKích hoạt một tài khoản người dùng mới được tạo và đặt mật khẩu đầu tiên – được bắt đầu qua liên kết trong email mời.

Bài viết liên quan

← Biểu mẫu công khai