- Yêu cầu HTTP
- Tham số đường dẫn
- Tham số truy vấn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi cấp phép
- BookingFailure
- Nguyên nhân
- PaymentFailureInformation
- ThreeDS1Parameters
Cập nhật một Booking
hiện có.
Yêu cầu HTTP
PATCH https://mapsbooking.googleapis.com/v1alpha/notification/{booking.name=partners/*/bookings/*}
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Các tham số | |
---|---|
booking.name |
Tên tài nguyên của lượt đặt trước: |
Tham số truy vấn
Các tham số | |
---|---|
updateMask |
Mặt nạ cho trường (field mask) của tất cả các trường đặt lịch hẹn sẽ được cập nhật Đây là danh sách các tên trường đủ điều kiện được phân tách bằng dấu phẩy. Ví dụ: |
bookingFailure |
Nếu yêu cầu đặt vé đã được xác nhận không đồng bộ và trạng thái của lượt đặt phòng đó đang được cập nhật thành KHÔNG THÀNH CÔNG, trường này sẽ phản ánh lỗi logic kinh doanh (ví dụ: người dùng hiện có một yêu cầu đặt chỗ quá gần với thời điểm này). Bạn chỉ nên đặt trường này khi cập nhật trạng thái đặt phòng thành FAILED và sẽ bị bỏ qua nếu không cập nhật. |
Nội dung yêu cầu
Nội dung yêu cầu chứa một bản sao của Booking
.
Nội dung phản hồi
Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của Booking
.
Phạm vi cấp phép
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/mapsbooking
BookingFailure
Dữ liệu trạng thái cho biết lý do không thể xử lý yêu cầu đặt phòng theo cách không đồng bộ. Mục đích của tính năng Đặt chỗ không thành công là chủ yếu ghi lại các lỗi về logic kinh doanh.
Biểu diễn dưới dạng JSON |
---|
{ "cause": enum ( |
Các trường | |
---|---|
cause |
Lý do không đặt được chỗ. (bắt buộc) |
rejectedCardType |
(chỉ bắt buộc nếu nguyên nhân là PAYMENT_ERROR_CARD_TYPE_ đấu giả) |
description |
Trường không bắt buộc này dùng để đối tác cung cấp thông tin bổ sung chỉ nhằm mục đích gỡ lỗi. (không bắt buộc) |
paymentFailure |
Thông tin về các lỗi thanh toán. |
Nguyên nhân
Bảng liệt kê các nguyên nhân gây lỗi.
Enum | |
---|---|
CAUSE_UNSPECIFIED |
Giá trị mặc định: Không sử dụng; dẫn đến "lỗi không xác định" |
SLOT_UNAVAILABLE |
Vị trí tình trạng rảnh/bận được đề cập không còn nữa. |
SLOT_ALREADY_BOOKED_BY_USER |
Người dùng đã đặt lịch hẹn cho khung giờ nhận đặt lịch hẹn được đề cập. |
LEASE_EXPIRED |
Hợp đồng thuê (nếu được cung cấp) đã hết hạn và không thể được dùng nữa để hoàn tất yêu cầu đặt phòng. |
OUTSIDE_CANCELLATION_WINDOW |
Hiện tại, không thể thực hiện yêu cầu huỷ do quy định hạn chế về thời gian trong chính sách huỷ của người bán. |
PAYMENT_ERROR_CARD_TYPE_REJECTED |
Đã xảy ra lỗi trong khi xử lý khoản thanh toán vì người bán không chấp nhận loại thẻ tín dụng đã cung cấp. Bạn phải cung cấp loại thẻ tín dụng trong trường CardType bị từ chối. |
PAYMENT_ERROR_CARD_DECLINED |
Đã xảy ra lỗi trong khi xử lý khoản thanh toán vì thẻ tín dụng được cung cấp đã bị từ chối. |
PAYMENT_OPTION_NOT_VALID |
Đã xảy ra lỗi với gói/gói thành viên dùng để thanh toán cho yêu cầu đặt trước. Có thể không còn lượt sử dụng hợp lệ nào, ứng dụng có thể đã hết hạn, v.v. |
PAYMENT_ERROR |
Đã xảy ra lỗi khi xử lý khoản thanh toán cho yêu cầu đặt chỗ này. Sử dụng giá trị này để biểu thị lỗi liên quan đến thanh toán chung, chỉ khi lỗi không khớp với lỗi thanh toán cụ thể ở trên. |
USER_CANNOT_USE_PAYMENT_OPTION |
Người dùng không thể sử dụng phương thức thanh toán đã cho (ví dụ: người dùng cố gắng sử dụng giá lần đầu tiên). |
BOOKING_ALREADY_CANCELLED |
Lượt đặt chỗ mà người dùng cố gắng huỷ đã bị huỷ. |
BOOKING_NOT_CANCELLABLE |
Không thể huỷ lượt đặt phòng mà người dùng đã cố gắng huỷ. |
OVERLAPPING_RESERVATION |
Người dùng hiện có một yêu cầu đặt chỗ quá gần thời điểm này. |
USER_OVER_BOOKING_LIMIT |
Không đặt được vé do người dùng đã vượt quá giới hạn lượt đặt trước trên mỗi người dùng của đơn vị tập hợp. |
PAYMENT_REQUIRES_3DS1 |
Đặt thời điểm khoản thanh toán bị từ chối vì bạn đang yêu cầu thử lại giao dịch, nhưng đây là lần này sau khi bạn trải qua quy trình thử thách/phản hồi 3DS1. Xin lưu ý rằng trạng thái không thành công của giao dịch hiện tại sẽ vẫn không thành công. Hoạt động thử lại sẽ hoàn toàn riêng biệt. Khi là lý do không thành công, bạn PHẢI đặt thông số paymentFailure.3DS1_parameters. Nếu không, thì nguyên nhân hiện tại sẽ được xử lý như thể là PAYMENT_ERROR. |
PaymentFailureInformation
Thông tin về các lỗi thanh toán.
Biểu diễn dưới dạng JSON |
---|
{
"threeds1Parameters": {
object ( |
Các trường | |
---|---|
threeds1Parameters |
Các tham số được trình tổng hợp RwG sử dụng để bắt đầu giao thức xác thực 3DS1 với người dùng. Sẽ được bỏ qua trừ khi ĐặtFailure.Destroy được đặt thành PAYMENT_REQUIRES_3DS1. |
ThreeDS1Parameters
Các tham số yêu cầu RwG thực hiện thử thách 3DS1.
Tham số được thiết lập theo mô tả của EMVCo về giao thức 3DS1.
Biểu diễn dưới dạng JSON |
---|
{ "acsUrl": string, "paReq": string, "transactionId": string, "mdMerchantData": string } |
Các trường | |
---|---|
acsUrl |
URL để tải biểu mẫu và hiển thị cho người dùng để xác thực. |
paReq |
Yêu cầu Xác thực Thanh toán. Để được đăng lên biểu mẫu ACSUrl nếu được cung cấp. |
transactionId |
Giá trị nhận dạng do nhà cung cấp ACS sử dụng. Để được đăng lên biểu mẫu ACSUrl nếu được cung cấp. |
mdMerchantData |
Dữ liệu người bán. Để được đăng lên biểu mẫu ACSUrl nếu được cung cấp. |