PaymentRequest
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
Giao diện PaymentRequest của Payment Request API là điểm truy cập chính vào API, cho phép nội dung web và ứng dụng nhận thanh toán từ người dùng cuối thay mặt cho đơn vị vận hành của trang web hoặc nhà phát hành của ứng dụng.
Hàm tạo
PaymentRequest()-
Tạo một đối tượng
PaymentRequestmới.
Thuộc tính thể hiện
PaymentRequest.idRead only-
Một định danh duy nhất cho một
PaymentRequestcụ thể, có thể được đặt thông quadetails.id. Khi không đặt, giá trị mặc định sẽ là UUID. PaymentRequest.shippingAddressRead only Deprecated Non-standard-
Nếu được yêu cầu qua tùy chọn thanh toán, trả về địa chỉ giao hàng mà người dùng đã chọn để phục vụ tính phí vận chuyển. Thuộc tính này chỉ được điền nếu hàm tạo được gọi với cờ
requestShippingđặt thành true. Ngoài ra, trong một số trình duyệt, các phần của địa chỉ sẽ bị che bớt vì quyền riêng tư cho đến khi người dùng cho biết họ đã sẵn sàng hoàn tất giao dịch (tức là họ nhấn "Pay"). PaymentRequest.shippingOptionRead only Deprecated Non-standard-
Trả về mã định danh của tùy chọn giao hàng đã chọn. Thuộc tính này chỉ được điền nếu hàm tạo được gọi với cờ
requestShippingđặt thành true. PaymentRequest.shippingTypeRead only Deprecated Non-standard-
Trả về kiểu giao hàng dùng để hoàn tất giao dịch. Giá trị này sẽ là một trong
shipping,delivery,pickup, hoặcnullnếu không có giá trị nào được cung cấp trong hàm tạo.
Phương thức tĩnh
-
Cho biết tính năng Secure payment confirmation có khả dụng hay không.
Phương thức thể hiện
PaymentRequest.canMakePayment()-
Cho biết đối tượng
PaymentRequestcó thể thực hiện thanh toán hay không trước khi gọishow(). PaymentRequest.show()-
Làm cho user agent bắt đầu tương tác người dùng cho yêu cầu thanh toán.
PaymentRequest.abort()-
Làm cho user agent kết thúc yêu cầu thanh toán và loại bỏ mọi giao diện người dùng đang hiển thị.
Sự kiện
merchantvalidationDeprecated-
Với một số payment handler (ví dụ: Apple Pay), trình xử lý sự kiện này được gọi để xử lý sự kiện
merchantvalidation, sự kiện được phát khi user agent yêu cầu merchant xác thực rằng merchant hoặc nhà cung cấp đang yêu cầu thanh toán là hợp lệ. paymentmethodchange-
Với một số payment handler (ví dụ: Apple Pay), được phát mỗi khi người dùng thay đổi phương thức thanh toán, như chuyển từ thẻ tín dụng sang thẻ ghi nợ.
shippingaddresschangeDeprecated Non-standard-
Được phát mỗi khi người dùng thay đổi địa chỉ giao hàng.
shippingoptionchangeDeprecated Non-standard-
Được phát mỗi khi người dùng thay đổi một tùy chọn giao hàng.
Thông số kỹ thuật
| Specification |
|---|
| Payment Request API> # paymentrequest-interface> |