- คำขอ HTTP
- พารามิเตอร์เส้นทาง
- พารามิเตอร์การค้นหา
- เนื้อความของคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- BookingFailure
- สาเหตุ
- PaymentFailureInformation
- ThreeDS1Parameters
อัปเดต Booking
ที่มีอยู่
คำขอ HTTP
PATCH https://mapsbooking.googleapis.com/v1alpha/notification/{booking.name=partners/*/bookings/*}
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์เส้นทาง
พารามิเตอร์ | |
---|---|
booking.name |
ชื่อทรัพยากรของการจอง: |
พารามิเตอร์การค้นหา
พารามิเตอร์ | |
---|---|
updateMask |
ต้องอัปเดตฟิลด์มาสก์ของช่องการจองทั้งหมด ซึ่งเป็นรายการชื่อฟิลด์ที่คั่นด้วยคอมมา ตัวอย่าง: |
bookingFailure |
หากการประมวลผลคำขอจองที่ยืนยันแล้วแบบไม่พร้อมกันไม่สำเร็จและสถานะการจองกำลังอัปเดตเป็น "ไม่สำเร็จ" ช่องนี้ควรแสดงข้อผิดพลาดด้านตรรกะทางธุรกิจ (เช่น ผู้ใช้มีการจองที่ใกล้กับเวลาดังกล่าวมากเกินไป) คุณควรตั้งค่าช่องนี้เฉพาะเมื่ออัปเดตสถานะการจองเป็น "ไม่สำเร็จ" เท่านั้น มิเช่นนั้นระบบจะไม่สนใจข้อมูลดังกล่าว |
เนื้อหาของคำขอ
เนื้อความของคำขอมีอินสแตนซ์ของ Booking
เนื้อหาการตอบกลับ
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ Booking
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth ต่อไปนี้
https://www.googleapis.com/auth/mapsbooking
BookingFailure
ข้อมูลสถานะซึ่งสื่อให้เห็นสาเหตุที่การประมวลผลการจองล้มเหลวแบบไม่พร้อมกัน BookingFailure มีวัตถุประสงค์เพื่อบันทึกข้อผิดพลาดด้านตรรกะทางธุรกิจเป็นหลัก
การแสดง JSON |
---|
{ "cause": enum ( |
ช่อง | |
---|---|
cause |
สาเหตุที่การจองล้มเหลว (ต้องระบุ) |
rejectedCardType |
(จำเป็นเฉพาะในกรณีที่สาเหตุคือ PAYMENT_ERROR_CARD_TYPE_REJECTED) |
description |
ช่องที่ไม่บังคับนี้ใช้สำหรับพาร์ทเนอร์เพื่อใส่ข้อมูลเพิ่มเติมเพื่อจุดประสงค์ในการแก้ไขข้อบกพร่องเท่านั้น (ไม่บังคับ) |
paymentFailure |
ข้อมูลเกี่ยวกับการชำระเงินที่ไม่สำเร็จ |
สาเหตุ
การแจกแจงสาเหตุที่ดำเนินการไม่สำเร็จ
Enum | |
---|---|
CAUSE_UNSPECIFIED |
ค่าเริ่มต้น: อย่าใช้ จำนวนจะเป็น "ข้อผิดพลาดที่ไม่รู้จัก" |
SLOT_UNAVAILABLE |
ช่วงเวลาว่างที่อ้างอิงไม่สามารถใช้ได้อีกต่อไป |
SLOT_ALREADY_BOOKED_BY_USER |
ผู้ใช้ได้จองการนัดหมายสำหรับช่วงเวลาว่างที่อ้างอิงแล้ว |
LEASE_EXPIRED |
เวลาเช่า (หากระบุ) หมดอายุแล้วและไม่สามารถใช้เพื่อจองให้เสร็จสมบูรณ์ได้อีกต่อไป |
OUTSIDE_CANCELLATION_WINDOW |
ดำเนินการยกเลิกตามที่ขอไม่ได้ในขณะนี้เนื่องจากนโยบายการยกเลิกของผู้ขายมีข้อจำกัดด้านเวลา |
PAYMENT_ERROR_CARD_TYPE_REJECTED |
เกิดข้อผิดพลาดขณะประมวลผลการชำระเงิน เนื่องจากผู้ขายไม่ยอมรับประเภทบัตรเครดิตที่ระบุ ต้องระบุประเภทบัตรเครดิตใน declinedCardType |
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 |
พารามิเตอร์ที่ใช้โดยผู้รวบรวมข้อมูล RwG เพื่อเริ่มโปรโตคอลการตรวจสอบสิทธิ์ 3DS1 กับผู้ใช้ ระบบจะไม่สนใจ เว้นแต่จะตั้งค่า BookingFailure.cause เป็น PAYMENT_REQUIRES_3DS1 |
ThreeDS1Parameters
พารามิเตอร์ที่ขอให้ RwG ทำชาเลนจ์ 3DS1
โดยกำหนดพารามิเตอร์ตามคำอธิบายของโปรโตคอล 3DS1 ของ EMVCo
การแสดง JSON |
---|
{ "acsUrl": string, "paReq": string, "transactionId": string, "mdMerchantData": string } |
ช่อง | |
---|---|
acsUrl |
URL ที่จะโหลดแบบฟอร์มเพื่อแสดงให้กับผู้ใช้เพื่อการตรวจสอบสิทธิ์ |
paReq |
คำขอ Payment Authentication เพื่อโพสต์ไปยังแบบฟอร์ม ACSUrl หากมี |
transactionId |
ตัวระบุที่ผู้ให้บริการ ACS ใช้ เพื่อโพสต์ไปยังแบบฟอร์ม ACSUrl หากมี |
mdMerchantData |
ข้อมูลผู้ขาย เพื่อโพสต์ไปยังแบบฟอร์ม ACSUrl หากมี |