- בקשת 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 |
מידע על כשלים בתשלומים. |
סיבה
פירוט הסיבות לכשל.
טיפוסים בני מנייה (enums) | |
---|---|
CAUSE_UNSPECIFIED |
ערך ברירת המחדל: לא לשימוש, מוגדר כ"שגיאה לא ידועה" |
SLOT_UNAVAILABLE |
משבצת הזמינות שצוינה לא זמינה יותר. |
SLOT_ALREADY_BOOKED_BY_USER |
המשתמש כבר קבע פגישה במשבצת הזמינות שצוינה. |
LEASE_EXPIRED |
פג התוקף של השכירות (אם סופקה) ואי אפשר יותר להשתמש בה כדי להשלים את ההזמנה המבוקשת. |
OUTSIDE_CANCELLATION_WINDOW |
לא ניתן לבצע את הביטול המבוקש כרגע עקב הגבלות זמן במדיניות הביטולים של המוכר. |
PAYMENT_ERROR_CARD_TYPE_REJECTED |
אירעה שגיאה במהלך עיבוד התשלום מכיוון שהמוכר לא קיבל את סוג כרטיס האשראי שצוין. יש לציין את סוג כרטיס האשראי בשדה deniedCardType. |
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 |
בקשת PaymentAuthentication. ההודעה תפורסם בטופס ACSUrl, אם סופק. |
transactionId |
מזהה המשמש את ספק ה-ACS. ההודעה תפורסם בטופס ACSUrl, אם סופק. |
mdMerchantData |
נתוני מוכרים. ההודעה תפורסם בטופס ACSUrl, אם סופק. |