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

Thuộc (ghi nhận cuối cùng) đơn hàng đã được tạo trước đó và được người mua phê duyệt trong quy trình thanh toán PayPal. Được xác thực trên máy chủ — khách hàng không thể thay đổi số tiền.

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

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

strictLimiter (10 yêu cầu/15 phút, liên kết IP).

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

Tham số

order_id(body, string, bắt buộc)— ID đơn hàng PayPal được cung cấp bởi 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 — order_id còn thiếu.
404 UNKNOWN_ORDER — order_id không phải là một đơn hàng đã được tạo trước đó.
409 CAPTURE_NOT_COMPLETED — Người mua chưa phê duyệt khoản thanh toán.
502 PAYPAL_CAPTURE_FAILED — Lỗi khi giao tiếp với PayPal.

Bằng chứng kiểm thử trực tiếp

Cả hai trường hợp lỗi đều đã được xác minh trực tuyến mà không có cấu hình PayPal (400 ORDER_ID_REQUIRED, 404 UNKNOWN_ORDER). Một trường hợp thành công thực sự sẽ đòi hỏi một giao dịch thanh toán sandbox PayPal có sự phê duyệt của người mua, điều này đã bị loại trừ theo quy định kiểm thử (không có các cuộc gọi đến nhà cung cấp thanh toán thực tế).

← Biểu mẫu công khai