- طلب 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
بيانات الحالة التي توضح سبب تعذّر معالجة الحجز بشكل غير متزامن. يهدف الحجز إلى رصد الأخطاء المنطقية في النشاط التجاري في المقام الأول.
تمثيل JSON |
---|
{ "cause": enum ( |
الحقول | |
---|---|
cause |
سبب تعذُّر الحجز. (معلومات مطلوبة) |
rejectedCardType |
(مطلوبة فقط إذا كان السبب هو PAYMENT_ERROR_CARD_TYPE_REJECTED) |
description |
يُستخدَم هذا الحقل الاختياري للشريك لتضمين معلومات إضافية لغرض تصحيح الأخطاء فقط. (اختياري) |
paymentFailure |
معلومات حول تعذُّر عمليات الدفع |
السبب
سرد أسباب الفشل.
عمليات التعداد | |
---|---|
CAUSE_UNSPECIFIED |
القيمة التلقائية: Don't use; إلى "خطأ غير معروف" |
SLOT_UNAVAILABLE |
لم تعُد خانة مدى التوفّر المُشار إليها متاحة. |
SLOT_ALREADY_BOOKED_BY_USER |
سبق أن حجز المستخدم موعدًا لخانة التوفّر المُشار إليها. |
LEASE_EXPIRED |
انتهت صلاحية مدة الإيجار (إذا تم توفيرها) ولا يمكن استخدامها بعد ذلك لإكمال الحجز المطلوب. |
OUTSIDE_CANCELLATION_WINDOW |
يتعذّر تنفيذ طلب الإلغاء المطلوب في الوقت الحالي بسبب القيود المفروضة على الوقت في سياسة الإلغاء لدى التاجر. |
PAYMENT_ERROR_CARD_TYPE_REJECTED |
حدث خطأ أثناء معالجة الدفعة لأنّ التاجر لم يقبل نوع بطاقة الائتمان الذي قدّمته. يجب تقديم نوع بطاقة الائتمان بـ disapprovalCardType. |
PAYMENT_ERROR_CARD_DECLINED |
حدث خطأ أثناء معالجة الدفعة بسبب رفض بطاقة الائتمان المقدّمة. |
PAYMENT_OPTION_NOT_VALID |
حدث خطأ في الحزمة/الاشتراك المستخدَم للدفع مقابل الحجز. ولم يتبق أي استخدامات صالحة، أو ربما انتهت صلاحيتها، أو غير ذلك. |
PAYMENT_ERROR |
حدث خطأ أثناء معالجة دفعة هذا الحجز. استخدِم هذه القيمة للإشارة إلى خطأ عام متعلق بالدفع، فقط إذا لم يتطابق الخطأ مع خطأ معيّن في الدفع أعلاه. |
USER_CANNOT_USE_PAYMENT_OPTION |
لا يمكن للمستخدم استخدام خيار الدفع المحدد (على سبيل المثال، المستخدم الذي يحاول استخدام السعر لأول مرة للمرة الثانية). |
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.
يتم تعيين المعلمات من خلال وصف EMVCo لبروتوكول 3DS1.
تمثيل JSON |
---|
{ "acsUrl": string, "paReq": string, "transactionId": string, "mdMerchantData": string } |
الحقول | |
---|---|
acsUrl |
عنوان URL الذي يتم من خلاله تحميل نموذج لتقديمه إلى المستخدم للمصادقة. |
paReq |
طلب مصادقة Payments ليتم نشره على نموذج ACSUrl في حال توفّره. |
transactionId |
معرّف يستخدمه موفّر خدمة ACS. ليتم نشره على نموذج ACSUrl في حال توفّره. |
mdMerchantData |
بيانات التاجر: ليتم نشره على نموذج ACSUrl في حال توفّره. |