- คำขอ 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 |
เกิดข้อผิดพลาดขณะประมวลผลการชำระเงินเนื่องจากผู้ขายไม่ยอมรับประเภทบัตรเครดิตที่ระบุ ประเภทบัตรเครดิตจะต้องระบุในประเภทบัตรที่ถูกปฏิเสธ |
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 |
คำขอ PaymentAuthentication โพสต์ไปยังแบบฟอร์ม ACSUrl หากมี |
transactionId |
ตัวระบุที่ผู้ให้บริการ ACS ใช้ โพสต์ไปยังแบบฟอร์ม ACSUrl หากมี |
mdMerchantData |
ข้อมูลผู้ขาย โพสต์ไปยังแบบฟอร์ม ACSUrl หากมี |