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.
Thuộc tính thể hiện
PaymentResponse.detailsRead 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.methodNameRead 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.payerEmailRead 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ànhtruetrong tham sốoptionscủa hàm dựngPaymentRequest(). PaymentResponse.payerNameRead 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ốoptionscủa hàm dựngPaymentRequest(). PaymentResponse.payerPhoneRead 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ànhtruetrong tham sốoptionscủa hàm dựngPaymentRequest(). PaymentResponse.requestIdRead 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ựngPaymentRequest()quadetails.id. PaymentResponse.shippingAddressRead 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ànhtruetrong tham sốoptionscủa hàm dựngPaymentRequest(). PaymentResponse.shippingOptionRead 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ànhtruetrong tham sốoptionscủa hàm dựngPaymentRequest().
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
PaymentResponsenà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> |