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

Tạo một đơn hàng PayPal cho gói đã chọn.

Gửi mã gói trong trường `package` và tùy chọn `email` của người đăng ký. Số tiền chỉ được xác định phía server từ gói. Khi thành công, đối tượng `data` của phản hồi chứa PayPal order ID `order_id`, cùng với `amount_cents` và `currency`; người mua dùng `order_id` này để phê duyệt thanh toán trong checkout PayPal. Sau đó bạn hoàn tất thanh toán bằng `POST /api/public/access-request/paypal/capture-order`. Gói không hợp lệ dẫn đến 400 `INVALID_PACKAGE`, địa chỉ email không hợp lệ dẫn đến 400 `INVALID_EMAIL`. Nếu PayPal hiện không khả dụng, endpoint trả lời bằng 503 `PAYPAL_NOT_READY`. Endpoint này giới hạn 10 yêu cầu mỗi 15 phút cho mỗi địa chỉ IP. Mỗi lệnh gọi thành công tạo một đơn hàng mới, không nên tự động thử lại.

Tổng quan

Lệnh gọi: POST /api/public/access-request/paypal/create-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: package (body). Các trường hợp lỗi được tài liệu hóa: 503 PAYPAL_NOT_READY. 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

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

Tham số

package(body, string, bắt buộc)— Mã gói của gói đã chọn

Request mẫu

{"package":"starter"}

Response mẫu

{"ok":false,"error":"PAYPAL_NOT_READY","message":"PayPal hiện không khả dụng."}

Mã lỗi

503 PAYPAL_NOT_READY — PayPal hiện không khả dụng.

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

Nếu không có kết nối PayPal khả dụng, lệnh gọi trả về 503 `PAYPAL_NOT_READY`. Trường hợp thành công yêu cầu một khoản thanh toán thực qua PayPal.

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/capture-orderHoà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.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