- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- क्वेरी पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति पाने के लिंक
- BookingFailure
- Cause
- PaymentFailureInformation
- ThreeDS1Parameters
मौजूदा Booking
को अपडेट करता है.
एचटीटीपी अनुरोध
PATCH https://mapsbooking.googleapis.com/v1alpha/notification/{booking.name=partners/*/bookings/*}
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
पाथ पैरामीटर
पैरामीटर | |
---|---|
booking.name |
बुकिंग के संसाधन का नाम: |
क्वेरी पैरामीटर
पैरामीटर | |
---|---|
updateMask |
सभी बुकिंग फ़ील्ड का फ़ील्ड मास्क अपडेट किया जाना है यह फ़ील्ड के पूरी तरह क्वालिफ़ाइड नाम की सूची है, जिसे कॉमा लगाकर अलग किया गया है. उदाहरण: |
bookingFailure |
अगर एसिंक्रोनस रूप से पुष्टि किए गए बुकिंग अनुरोध को प्रोसेस नहीं किया जा सकता है और बुकिंग की स्थिति को FAILED में अपडेट किया जा रहा है, तो इस फ़ील्ड में कारोबार के लॉजिक से जुड़ी गड़बड़ी दिखनी चाहिए. उदाहरण के लिए, उपयोगकर्ता की मौजूदा बुकिंग इस समय के काफ़ी करीब है. इस फ़ील्ड को सिर्फ़ तब सेट किया जाना चाहिए, जब बुकिंग के स्टेटस को 'प्रोसेस नहीं किया गया' के तौर पर अपडेट किया जा रहा हो. ऐसा न होने पर इसे अनदेखा कर दिया जाएगा. |
अनुरोध का मुख्य भाग
अनुरोध के मुख्य भाग में Booking
का उदाहरण है.
जवाब का मुख्य भाग
कामयाब रहने पर, जवाब के मुख्य हिस्से में Booking
का एक इंस्टेंस शामिल किया जाता है.
अनुमति पाने के लिंक
नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:
https://www.googleapis.com/auth/mapsbooking
BookingFailure
स्टेटस डेटा, जो बताता है कि बुकिंग की प्रोसेसिंग एसिंक्रोनस तरीके से क्यों नहीं हो सकी. बुकिंगFailure का मकसद मुख्य रूप से कारोबार के लॉजिक की गड़बड़ियों को कैप्चर करना है.
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 |
पेमेंट प्रोसेस करते समय गड़बड़ी हुई, क्योंकि व्यापारी/कंपनी ने इस तरह के क्रेडिट कार्ड को स्वीकार नहीं किया. क्रेडिट कार्ड के प्रकार की आपूर्ति अस्वीकार किए गएCardType में की जानी चाहिए. |
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 पुष्टि करने वाला प्रोटोकॉल शुरू किया जा सके. इसे तब तक अनदेखा किया जाएगा, जब तक बुकिंगFailure.cause को PAYMENT_REQUIRES_3DS1 पर सेट न किया गया हो. |
ThreeDS1Parameters
वे पैरामीटर जो अनुरोध करते हैं कि RwG एक 3DS1 चैलेंज करे.
EMVCo के 3DS1 प्रोटोकॉल के ब्यौरे के हिसाब से पैरामीटर सेट किए जाते हैं.
JSON के काेड में दिखाना |
---|
{ "acsUrl": string, "paReq": string, "transactionId": string, "mdMerchantData": string } |
फ़ील्ड | |
---|---|
acsUrl |
वह यूआरएल जिससे पुष्टि करने के लिए उपयोगकर्ता को फ़ॉर्म लोड करना है. |
paReq |
पेमेंट की पुष्टि करने का अनुरोध. अगर जानकारी दी गई है, तो इसे ACSUrl फ़ॉर्म पर पोस्ट किया जाना चाहिए. |
transactionId |
ऐसा आइडेंटिफ़ायर जिसका इस्तेमाल ACS सेवा देने वाली कंपनी करती है. अगर जानकारी दी गई है, तो इसे ACSUrl फ़ॉर्म पर पोस्ट किया जाना चाहिए. |
mdMerchantData |
कारोबारी या कंपनी का डेटा. अगर जानकारी दी गई है, तो इसे ACSUrl फ़ॉर्म पर पोस्ट किया जाना चाहिए. |