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.

EventTarget PaymentRequest

Hàm tạo

PaymentRequest()

Tạo một đối tượng PaymentRequest mới.

Thuộc tính thể hiện

PaymentRequest.id Read only

Một định danh duy nhất cho một PaymentRequest cụ thể, có thể được đặt thông qua details.id. Khi không đặt, giá trị mặc định sẽ là UUID.

PaymentRequest.shippingAddress Read 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.shippingOption Read 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.shippingType Read 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ặc null nếu không có giá trị nào được cung cấp trong hàm tạo.

Phương thức tĩnh

PaymentRequest.securePaymentConfirmationAvailability() Experimental

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 PaymentRequest có thể thực hiện thanh toán hay không trước khi gọi show().

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

merchantvalidation Deprecated

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ợ.

shippingaddresschange Deprecated Non-standard

Được phát mỗi khi người dùng thay đổi địa chỉ giao hàng.

shippingoptionchange Deprecated 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

Tương thích trình duyệt