POST/api/public/access-request/stripe/create-checkout
Tạo một session checkout Stripe cho gói đã chọn.
Gửi mã gói trong trường `package`, tùy chọn `email` của người đăng ký, và trong `payment_method_types` các phương thức thanh toán mong muốn (mặc định: thẻ; ghi nợ trực tiếp SEPA nếu được bật). Khi thành công, đối tượng `data` của phản hồi chứa `session_id` và `url` của trang checkout Stripe mà bạn sẽ chuyển hướng người mua đến. Số tiền chỉ được xác định phía server. Gói không hợp lệ dẫn đến 400 `INVALID_PACKAGE`. Nếu Stripe hiện không khả dụng, endpoint trả lời bằng 503 `STRIPE_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 session mới, không nên tự động thử lại.
Tổng quan
Lệnh gọi: POST /api/public/access-request/stripe/create-checkout. 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 STRIPE_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ọnRequest mẫu
{"package":"starter"}Response mẫu
{"ok":false,"error":"STRIPE_NOT_READY","message":"Thanh toán Stripe hiện không khả dụng."}Mã lỗi
503 STRIPE_NOT_READY — Stripe hiện không khả dụng.Hành vi đã được xác minh
Nếu không có kết nối Stripe khả dụng, lệnh gọi trả về 503 `STRIPE_NOT_READY`. Trường hợp thành công yêu cầu một khoản thanh toán thực qua Stripe.
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/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/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.