PaymentResponse

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 PaymentResponse của Payment Request API được trả về sau khi người dùng chọn một phương thức thanh toán và chấp thuận yêu cầu thanh toán.

EventTarget PaymentResponse

Thuộc tính thể hiện

PaymentResponse.details Read only

Trả về một đối tượng có thể tuần tự hóa thành JSON, cung cấp thông điệp đặc thù cho phương thức thanh toán để người bán xử lý giao dịch và xác định việc chuyển tiền thành công. Nội dung của đối tượng phụ thuộc vào phương thức thanh toán đang dùng. Nhà phát triển cần tham khảo bên kiểm soát URL để biết cấu trúc mong đợi của đối tượng details.

PaymentResponse.methodName Read only

Trả về mã định danh của phương thức thanh toán mà người dùng đã chọn, ví dụ Visa, Mastercard, PayPal, v.v.

PaymentResponse.payerEmail Read only

Trả về địa chỉ email do người dùng cung cấp. Tùy chọn này chỉ xuất hiện khi tùy chọn requestPayerEmail được đặt thành true trong tham số options của hàm dựng PaymentRequest().

PaymentResponse.payerName Read only

Trả về tên do người dùng cung cấp. Tùy chọn này chỉ xuất hiện khi tùy chọn requestPayerName được đặt thành true trong tham số options của hàm dựng PaymentRequest().

PaymentResponse.payerPhone Read only

Trả về số điện thoại do người dùng cung cấp. Tùy chọn này chỉ xuất hiện khi tùy chọn requestPayerPhone được đặt thành true trong tham số options của hàm dựng PaymentRequest().

PaymentResponse.requestId Read only

Trả về mã định danh của PaymentRequest đã tạo ra phản hồi hiện tại. Đây là cùng giá trị được cung cấp trong hàm dựng PaymentRequest() qua details.id.

PaymentResponse.shippingAddress Read only

Trả về địa chỉ giao hàng do người dùng cung cấp. Tùy chọn này chỉ xuất hiện khi tùy chọn requestShipping được đặt thành true trong tham số options của hàm dựng PaymentRequest().

PaymentResponse.shippingOption Read only

Trả về thuộc tính ID của tùy chọn giao hàng mà người dùng đã chọn. Tùy chọn này chỉ xuất hiện khi tùy chọn requestShipping được đặt thành true trong tham số options của hàm dựng PaymentRequest().

Phương thức thể hiện

PaymentResponse.retry()

Nếu có gì đó không đúng với dữ liệu của phản hồi thanh toán (và có lỗi có thể khôi phục), phương thức này cho phép người bán yêu cầu người dùng thử lại thanh toán. Phương thức nhận một đối tượng làm đối số, đối tượng này được dùng để báo cho người dùng biết chính xác điều gì sai với phản hồi thanh toán để họ có thể sửa các vấn đề.

PaymentResponse.complete()

Thông báo cho user agent rằng tương tác của người dùng đã kết thúc. Điều này sẽ đóng mọi giao diện người dùng còn lại. Chỉ nên gọi phương thức này sau Promise do phương thức PaymentRequest.show() trả về.

PaymentResponse.toJSON()

Trả về một đối tượng JSON đại diện cho đối tượng PaymentResponse này.

Sự kiện

Nghe sự kiện này bằng addEventListener() hoặc bằng cách gán một trình xử lý sự kiện cho thuộc tính oneventname của giao diện này.

payerdetailchange

Được phát trong quá trình thử lại khi người dùng thay đổi thông tin cá nhân của họ trong lúc điền biểu mẫu yêu cầu thanh toán. Cho phép nhà phát triển xác thực lại bất kỳ dữ liệu người dùng nào đã yêu cầu, ví dụ số điện thoại hoặc địa chỉ email, nếu chúng thay đổi.

Đặc tả

Specification
Payment Request API
# paymentresponse-interface

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