Method: notification.partners.bookings.patch

อัปเดต Booking ที่มีอยู่

คำขอ HTTP

PATCH https://mapsbooking.googleapis.com/v1alpha/notification/{booking.name=partners/*/bookings/*}

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
booking.name

string

ชื่อทรัพยากรของการจอง: partners/{partner ID}/bookings/{booking ID}

พารามิเตอร์การค้นหา

พารามิเตอร์
updateMask

string (FieldMask format)

มาสก์ของช่องของฟิลด์การจองทั้งหมดที่จะอัปเดต

ซึ่งเป็นรายการชื่อที่ตรงตามเกณฑ์ทั้งหมดของช่องที่คั่นด้วยคอมมา ตัวอย่าง: "user.displayName,photo"
bookingFailure

object (BookingFailure)

หากประมวลผลคำขอการจองที่ยืนยันแล้วเป็นแบบไม่พร้อมกันไม่สำเร็จและระบบอัปเดตสถานะการจองเป็น "ล้มเหลว" ช่องนี้ควรแสดงข้อผิดพลาดด้านตรรกะทางธุรกิจ (เช่น ผู้ใช้มีการจองที่ใกล้กับเวลานี้มากเกินไป) คุณควรตั้งค่าช่องนี้เมื่ออัปเดตสถานะการจองเป็น "ล้มเหลว" เท่านั้น มิฉะนั้นระบบจะไม่สนใจ

เนื้อหาของคำขอ

เนื้อความของคำขอมีอินสแตนซ์ของ Booking

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ Booking

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/mapsbooking

BookingFailure

ข้อมูลสถานะที่แสดงให้เห็นสาเหตุที่การประมวลผลการจองล้มเหลวแบบไม่พร้อมกัน BookingFailure มีจุดประสงค์เพื่อตรวจจับข้อผิดพลาดด้านตรรกะทางธุรกิจเป็นหลัก

การแสดง JSON 
{
  "cause": enum (Cause),
  "rejectedCardType": enum (CreditCardType),
  "description": string,
  "paymentFailure": {
    object (PaymentFailureInformation)
  }
}
ช่อง
cause

enum (Cause)

สาเหตุที่การจองล้มเหลว (ต้องระบุ)
rejectedCardType

enum (CreditCardType)

(จำเป็นเฉพาะในกรณีที่สาเหตุคือ PAYMENT_ERROR_CARD_TYPE_REJECTED )
description

string

ช่องที่ไม่บังคับนี้ใช้สำหรับพาร์ทเนอร์เพื่อระบุข้อมูลเพิ่มเติมเพื่อจุดประสงค์ในการแก้ไขข้อบกพร่องเท่านั้น (ไม่บังคับ)
paymentFailure

object (PaymentFailureInformation)

ข้อมูลเกี่ยวกับการชำระเงินไม่สำเร็จ

สาเหตุ

การแจงนับสาเหตุของความล้มเหลว

Enum
CAUSE_UNSPECIFIED ค่าเริ่มต้น: โปรดอย่าใช้ ทำให้เกิด "ข้อผิดพลาดที่ไม่ทราบสาเหตุ"
SLOT_UNAVAILABLE สล็อตความพร้อมจำหน่ายสินค้าที่อ้างอิงอยู่ไม่สามารถใช้ได้แล้ว
SLOT_ALREADY_BOOKED_BY_USER ผู้ใช้ได้จองการนัดหมายสำหรับช่วงเวลาว่างที่อ้างอิงแล้ว
LEASE_EXPIRED สัญญาเช่า (หากระบุ) หมดอายุแล้วและไม่สามารถนำมาใช้เพื่อทำการจองให้เสร็จสมบูรณ์ได้อีกต่อไป
OUTSIDE_CANCELLATION_WINDOW ไม่สามารถดำเนินการยกเลิกตามที่ขอได้ในขณะนี้ เนื่องจากข้อจำกัดด้านเวลาในนโยบายการยกเลิกของผู้ขาย
PAYMENT_ERROR_CARD_TYPE_REJECTED เกิดข้อผิดพลาดขณะประมวลผลการชำระเงินเนื่องจากผู้ขายไม่ยอมรับประเภทบัตรเครดิตที่ระบุ ประเภทบัตรเครดิตจะต้องระบุในประเภทบัตรที่ถูกปฏิเสธ
PAYMENT_ERROR_CARD_DECLINED เกิดข้อผิดพลาดขณะประมวลผลการชำระเงินเนื่องจากบัตรเครดิตที่ระบุถูกปฏิเสธ
PAYMENT_OPTION_NOT_VALID พบข้อผิดพลาดเกี่ยวกับแพ็กเกจ/การเป็นสมาชิกที่ใช้ชำระค่าจอง ไม่มีการใช้งานที่ถูกต้องเหลืออยู่แล้ว อาจหมดอายุแล้ว ฯลฯ
PAYMENT_ERROR เกิดข้อผิดพลาดขณะประมวลผลการชำระเงินสำหรับการจองนี้ ใช้ค่านี้เพื่อระบุข้อผิดพลาดทั่วไปเกี่ยวกับการชำระเงินในกรณีที่ข้อผิดพลาดไม่ตรงกับข้อผิดพลาดการชำระเงินที่เฉพาะเจาะจงข้างต้นเท่านั้น
USER_CANNOT_USE_PAYMENT_OPTION ผู้ใช้ไม่สามารถใช้ตัวเลือกการชำระเงินที่ระบุ (เช่น ผู้ใช้พยายามใช้ราคาครั้งแรกเป็นครั้งที่ 2)
BOOKING_ALREADY_CANCELLED การจองที่ผู้ใช้พยายามยกเลิกถูกยกเลิกแล้ว
BOOKING_NOT_CANCELLABLE การจองที่ผู้ใช้พยายามยกเลิกจะยกเลิกไม่ได้
OVERLAPPING_RESERVATION ผู้ใช้มีการจองที่ใกล้กับเวลานี้มากเกินไป
USER_OVER_BOOKING_LIMIT จองไม่สําเร็จเนื่องจากผู้ใช้มีการจองต่อผู้ใช้เกินขีดจํากัด
PAYMENT_REQUIRES_3DS1

กำหนดเมื่อการชำระเงินถูกปฏิเสธเนื่องจากคุณขอให้ลองทำธุรกรรมอีกครั้ง แต่ครั้งนี้หลังจากดำเนินการทดสอบ/ตอบกลับ 3DS1 โปรดทราบว่าสถานะการดำเนินการไม่สำเร็จของธุรกรรมปัจจุบันจะยังคงล้มเหลวต่อไป ทั้งนี้ การลองใหม่จะแยกจากกันโดยสิ้นเชิง

หากเป็นสาเหตุที่ทำให้การทำงานล้มเหลว ต้องตั้งค่า paymentFailure.3DS1_parameters หากไม่เป็นเช่นนั้น สาเหตุปัจจุบันจะถือเป็น PAYMENT_ERROR

PaymentFailureInformation

ข้อมูลเกี่ยวกับการชำระเงินไม่สำเร็จ

การแสดง JSON 
{
  "threeds1Parameters": {
    object (ThreeDS1Parameters)
  }
}
ช่อง
threeds1Parameters

object (ThreeDS1Parameters)

พารามิเตอร์ที่ผู้รวบรวมข้อมูล RwG ใช้เพื่อเริ่มต้นโปรโตคอลการตรวจสอบสิทธิ์ 3DS1 กับผู้ใช้ จะถูกละเว้นเว้นแต่ตั้งค่า BookingFailure.cause เป็น PAYMENT_REQUIRES_3DS1

ThreeDS1Parameters

พารามิเตอร์ที่ขอให้ RwG ดำเนินการทดสอบ 3DS1

พารามิเตอร์กำหนดตามคำอธิบายโปรโตคอล 3DS1 ของ EMVCo

การแสดง JSON 
{
  "acsUrl": string,
  "paReq": string,
  "transactionId": string,
  "mdMerchantData": string
}
ช่อง
acsUrl

string

URL ที่จะใช้โหลดฟอร์มเพื่อนำเสนอแก่ผู้ใช้สำหรับการตรวจสอบสิทธิ์
paReq

string

คำขอ PaymentAuthentication โพสต์ไปยังแบบฟอร์ม ACSUrl หากมี
transactionId

string

ตัวระบุที่ผู้ให้บริการ ACS ใช้ โพสต์ไปยังแบบฟอร์ม ACSUrl หากมี
mdMerchantData

string

ข้อมูลผู้ขาย โพสต์ไปยังแบบฟอร์ม ACSUrl หากมี