Actions Center प्लैटफ़ॉर्म पर कई तरह के कॉन्फ़िगरेशन इस्तेमाल किए जा सकते हैं पेमेंट करने के लिए. कॉन्टेंट बनाने पेमेंट गाइड चालू करने में इंटिग्रेशन के वे पहलू शामिल हैं जो ये सभी पेमेंट इंटिग्रेशन में सामान्य हैं:
tokenization_parameter
की जानकारी शामिल करने के लिए, फ़ीड को कॉन्फ़िगर किया जा रहा हैpayment_method_token
स्वीकार करने के लिए, बुकिंग सर्वर को अपडेट किया जा रहा है चीज़ें- उपयोगकर्ता के बीच हुई जानकारी के लेन-देन की खास जानकारी, ऐक्शन सेंटर, पार्टनर / व्यापारी/कंपनी और पेमेंट प्रोसेस करने वाली कंपनी के तौर पर काम करता है.
हम इस गाइड में ज़्यादा जानकारी देंगे कि अपने फ़ीड को कॉन्फ़िगर करें. इससे आपको पता चलेगा कि किस तरह के विज्ञापन पेमेंट के कॉन्फ़िगरेशन, आपकी कंपनी और उनकी सेवाओं पर लागू होते हैं.
- कोई पेमेंट नहीं / पेमेंट ऑन पहुंचने का समय
- पहले से किया गया पूरा पेमेंट
- न पहुंचने का शुल्क / बुकिंग रद्द करने का शुल्क
- जमा
पेमेंट के सभी उदाहरण, पेमेंट न करने वाले एक्सटेंशन के तौर पर मौजूद हैं / ग्राहक पहुंचने पर पेमेंट का इस्तेमाल (इसके लिए, पेमेंट के तरीके को कॉन्फ़िगर करने की ज़रूरत नहीं होती) ट्यूटोरियल की शुरुआत में उस कॉन्फ़िगरेशन और अन्य के साथ कॉन्फ़िगरेशन को एक्सटेंशन के रूप में कॉन्फ़िगर करता है.
हर सेक्शन में, ट्रैक किए जाने वाले फ़ील्ड भी शामिल होंगे किसी पेमेंट को स्वीकार करने के लिए, बुकिंग सर्वर कॉन्फ़िगरेशन.
कोई पेमेंट नहीं / पेमेंट ऑन पहुंचने का समय
ऐसी सेवाएं जिनके लिए बुकिंग करते समय कोई शुल्क नहीं देना पड़ता, व्यापारी/कंपनी/कारोबारी या सेवा के लिए, पेमेंट के तरीके को कॉन्फ़िगर करने की ज़रूरत नहीं है लेवल. हालांकि, कीमतों की जानकारी देना अब भी ज़रूरी है.
यह किसी सेवा का बेसलाइन कॉन्फ़िगरेशन है, जिसमें
नाम, ब्यौरा, और कीमत. यह सिर्फ़ एक सेवा मैसेज होगा
के अंदर
ServiceFeed
:
JSON
{ "merchant_id": "merchant-1", "service_id": "service-1-a", "name": "Men's haircut", "description": "One of our stylists will cut your hair", "price": { "price_micros": 15000000, "currency_code": "USD" } }
स्टैंडर्ड तरीके से लागू करने के अलावा, किसी और कॉन्फ़िगरेशन की ज़रूरत नहीं है तक पहुंचने के बाद पेमेंट करने में मदद करने के लिए, बुकिंग सर्वर में.
पूर्व-भुगतान
इस कॉन्फ़िगरेशन का इस्तेमाल, सेवा में इस्तेमाल होने वाले शुल्क की जानकारी देने के लिए किया जाता है बुकिंग के समय ही पूरा पैसा चुकाना होगा.
प्रीपेमेंट सेवा स्तर पर इसके माध्यम से दर्ज किया जाता है:
prepayment_type
फ़ील्ड में
Service
. इस सेवा के लिए पेमेंट ज़रूरी करना
यह REQUIRED
पर सेट होना चाहिए, जैसा कि नीचे दिए गए उदाहरण में बताया गया है. ध्यान दें कि
कीमत को पहुंचने पर पेमेंट के उदाहरण की तरह ही बताया गया है. यहां,
क्योंकि हम प्रीपेमेंट प्रकार को आवश्यक पर सेट कर रहे हैं, इसलिए क्रेडिट कार्ड
ली गई है और यह कीमत चेकआउट के समय ली जा सकती है.
JSON
{ "merchant_id": "merchant-1", "service_id": "service-2-b", "name": "Spa Treatment", "description": "A full spa treatment", "price": { "price_micros": "200000000", "currency_code": "USD" } "prepayment_type": "REQUIRED" }
बुकिंग सर्वर
पहले पेमेंट स्वीकार करने पर, आपकी बुकिंग को पेमेंट टोकन भेज दिया जाता है
सर्वर को
फ़ील्ड के ज़रिए CreateBooking
payment_processing_parameters.unparsed_payment_method_token
.
आपको ठीक वही शुल्क देना होगा जो
फ़ीड में मूल्य फ़ील्ड है और आपको मुद्रा का उपयोग करना होगा
फ़ीड में मौजूद है. ये शुल्क, बताए गए फ़्लो के हिसाब से होने चाहिए
में
पेमेंट गाइड की सुविधा चालू करना.
रिटर्न करते समय
CreateBookingResponse
booking.payment_information
फ़ील्ड को ठीक से पर सेट किया जाना चाहिए
यह बताना कि ऐडवांस पेमेंट कर दिया गया है और उसे प्रोसेस किया जा चुका है.
कॉन्टेंट बनाने
PaymentInformation
स्पेसिफ़िकेशन में सभी चीज़ें शामिल हैं
भुगतान जानकारी के सभी विकल्पों के लिए दस्तावेज़. कम से कम शब्दों में
पहले से किए गए पेमेंट की जानकारी नीचे दी गई है. यह ज़रूरी है कि कीमत
जो कीमत फ़ील्ड में दी गई है, उससे एग्ज़ैक्ट मैच करती है
अनुरोध. इसके अलावा, अगर फ़ीड/अनुरोध में टैक्स की कोई दर बताई गई है, तो
भी शामिल किए जाने चाहिए.
यह भी ध्यान रखें कि आपको एक लेन-देन आईडी भी देनी होगी. यह लेन-देन आईडी यह ज़रूरी है कि उस व्यापारी/कंपनी के साथ किए जाने वाले लेन-देन के मामले में, वह कम से कम अलग हो. ऐप्लिकेशन लेन-देन आईडी के लिए अच्छा उम्मीदवार वह लेन-देन आईडी होता है, जिसे आपके पेमेंट प्रोसेस करने वाली कंपनी ने आपको किया है.
JSON
{ "prepayment_status": "PREPAYMENT_PROVIDED", "payment_processed_by": "PROCESSED_BY_PARTNER", "payment_transaction_id": "[this-transaction-id]", "price": { "price_micros": "200000000", "currency_code": "USD" } }
बिना शो का शुल्क
इवेंट में न आने की स्थिति में, उपयोगकर्ता से या अगर वे 18 दिन बाद रद्द करते हैं, रद्द करने की विंडो. अगर रद्द करने की कोई विंडो तय नहीं की गई है, तो डिफ़ॉल्ट रूप से, स्लॉट के शुरू होने का समय सेट होता है.
न पहुंचने का शुल्क बताने के लिए, सर्विस फ़ीड में आपको
no_show_fee
फ़ील्ड का नाम, जैसा कि नीचे दिए गए उदाहरण में दिखाया गया है:
JSON
{ "merchant_id": "merchant-1", "service_id": "service-2-b", "name": "Spa Treatment", "description": "A full spa treatment", "price": { "price_micros": 200000000, "currency_code": "USD" } "scheduling_rules": { "min_advance_online_canceling": 14400, } "no_show_fee": { "fee": { "price_micros": 25000000, "currency_code": "USD" } "fee_type": "FIXED_RATE_DEFAULT" } }
ऊपर दिए गए उदाहरण में, पार्टनर या व्यापारी/कंपनी/कारोबारी को
25 डॉलर का तय शुल्क लिया जाता है, जो
no_show_fee.fee.price_micros
फ़ील्ड, अगर अपॉइंटमेंट होल्डर
अपॉइंटमेंट में शामिल नहीं होता है. यह शुल्क तब भी लिया जा सकता है, जब उपयोगकर्ता
अपॉइंटमेंट से 4 घंटे (14,400 सेकंड) पहले रद्द कर देता है, क्योंकि
scheduling_rules.min_advance_online_canceling
में बताया गया है
फ़ील्ड में डालें.
अगर आपको जानना है कि खरीदारी के लिए उपलब्धता के लेवल पर, शो का शुल्क कैसे तय किया जाता है, तो यहां जाएं: यह सेक्शन देखें.
बुकिंग सर्वर
न पहुंचने का शुल्क वाले अनुरोध को प्रोसेस करते समय, पेमेंट टोकन
आपके बुकिंग सर्वर को इस कॉल में पास किया जाता है:
फ़ील्ड के ज़रिए CreateBooking
payment_processing_parameters.unparsed_payment_method_token
.
यह टोकन उसी तरह से पास किया जाता है जैसे कि पहले पेमेंट किया जाता है
केस. हालांकि, टोकन को कुछ समय के लिए ही इस्तेमाल किया जा सकता है
समय की, आपको अपने भुगतान प्रोसेसर के प्रासंगिक API को कॉल करना होगा
इस टोकन को ऐसे वर्शन में अपग्रेड करें जिसे आप
बाद में बंद कर सकते हैं. इसके बारे में, पेमेंट के तरीके की जानकारी देने वाली गाइड के सेक्शन में बताया गया है
तारीख
नो-शो शुल्क वाला टोकन फ़्लो.
रिटर्न करते समय
CreateBookingResponse
booking.payment_information
फ़ील्ड को सही तरीके से सेट करना ज़रूरी है
नीचे दिए गए उदाहरण की तरह, न पहुंचने का शुल्क भी वापस लें.
JSON
{ "prepayment_status": "PREPAYMENT_PROVIDED", "payment_processed_by": "PROCESSED_BY_PARTNER", "payment_transaction_id": "[this-transaction-id]", "price": { "price_micros": "200000000", "currency_code": "USD" } "no_show_fee": { "fee": { "price_micros": 25000000, "currency_code": "USD" } "fee_type": "FIXED_RATE_DEFAULT" } }
ध्यान दें कि no_show_fee
को कीमत दिखाने के लिए सेट किया गया है और
लगाए जाने वाले शुल्क का स्ट्रक्चर भी देख सकते हैं. यह भी ध्यान रखें कि,
पहले पेमेंट का उदाहरण: इस मैसेज में transaction_id
होना ज़रूरी है.
यह भी ध्यान रखें कि booking_id
CreateBookingResponse
रीयल-टाइम अपडेट के लिए एक आवश्यक फ़ील्ड है, जिसे चार्ज करते समय भेजा जाना चाहिए
न पहुंचने का शुल्क देना होगा. उम्मीद है कि इस आईडी को जानकारी के साथ सेव किया जाएगा
बुकिंग के बारे में जानकारी.
रीयल-टाइम अपडेट
अगर कोई उपयोगकर्ता शेड्यूल की गई बुकिंग के लिए नहीं आता है या रद्द कर देता है सदस्यता रद्द करने की समयसीमा खत्म होने के बाद, (उदाहरण के लिए, सीधे आपसे संपर्क करके), पेमेंट की जानकारी का इस्तेमाल करके, न पहुंचने पर तय शुल्क ले सकता है जो बुकिंग के समय सेव किए गए थे. अगर न पहुंचने पर कोई शुल्क लिया जाता है, तो आपको रीयल-टाइम अपडेट जिसमें बताया गया हो कि न पहुंचने का शुल्क लिया गया.
इन खातों से बनाई गई बुकिंग के लिए
CreateBooking
, अपडेट इस ईमेल पते पर भेजा जाना चाहिए
notification.partners.bookings.patch
. इस अनुरोध के मुख्य हिस्से में यह होना चाहिए:
अपडेट की गई बुकिंग, जिसका स्टेटस
NO_SHOW_PENALIZED
. इस स्थिति से Google को पता चलता है कि कोई शुल्क
बनाया गया.
उदाहरण के लिए, अनुरोध यहां भेजा जा सकता है:
PATCH https://mapsbooking.googleapis.com/v1alpha/notification/partners/12345678/bookings/123123123?updateMask=status
अनुरोध के मुख्य हिस्से के साथ:
JSON
{ "name": "partners/12345678/bookings/123123123" "merchantId": "merchant-1" "serviceId": "service-2-b" "status": "NO_SHOW_PENALIZED" }
जमा
ज़रूरत के तौर पर, जमा रकम का इस्तेमाल शुरुआती शुल्क लेने के लिए किया जाता है बुकिंग. इन डिपॉज़िट को बुकिंग के समय या बाद में लिया जा सकता है समय. आपको यह बताना पड़ सकता है कि जमा की गई रकम किन शर्तों के तहत रिफ़ंड की जा सकती है साथ ही ऑनलाइन बुकिंग कब रद्द की जा सकती है.
डिपॉज़िट की जानकारी देने के लिए, सर्विस फ़ीड में आपको यह जानकारी शामिल करनी होगी
deposit
फ़ील्ड का नाम, जैसा कि नीचे दिए गए उदाहरण में दिखाया गया है:
JSON
{ "merchant_id": "merchant-1", "service_id": "service-2-b", "name": "Spa Treatment", "description": "A full spa treatment", "price": { "price_micros": 200000000, "currency_code": "USD" } "scheduling_rules": { "min_advance_online_canceling": 86400, } "deposit": { "deposit": { "price_micros": 25000000, "currency_code": USD, "min_advance_cancellation_sec": 14400, } "deposit_type": "FIXED_RATE_DEFAULT" } }
इस उदाहरण में,
min_advance_online_canceling
, सदस्यता रद्द करने की विंडो और
deposit.min_advance_cancellation_sec
तय करता है कि जमा की गई रकम कब रिफ़ंड की जाएगी. ध्यान दें कि ऊपर दिए गए उदाहरण में जमा रकम में
रद्द करने का समय और रिफ़ंड की शर्तों से अलग होना चाहिए. इस स्थिति में, उपयोगकर्ता अपनी सदस्यता रद्द करने में
24 घंटे पहले (86,400 सेकंड) तक ऑनलाइन सेवा. इससे पक्का होता है कि कारोबारी
देरी से रद्द करने पर, सीधे तौर पर सूचना देंगे. हालांकि, उपयोगकर्ता अब भी
जमा किए गए पैसे का रिफ़ंड चार घंटे पहले तक मिल सकता है
बुकिंग से पहले (14,400 सेकंड) (रद्द करने के लिए आपसे या व्यापारी/कंपनी से संपर्क करके),
जिसे चेकआउट के समय शर्तों में और पुष्टि करने वाले ईमेल में दिखाया जाएगा.
यह देखने के लिए कि उपलब्धता स्तर पर जमा को कैसे परिभाषित किया जा सकता है, देखें यह सेक्शन देखें.
बुकिंग सर्वर
पेमेंट टोकन वाले किसी अनुरोध को प्रोसेस करते समय,
आपके बुकिंग सर्वर को इस कॉल में भेजा जाता है:
फ़ील्ड के ज़रिए CreateBooking
payment_processing_parameters.unparsed_payment_method_token
.
यह टोकन उसी तरीके से पास किया जाता है जैसे कि पहले पेमेंट के मामले में किया जाता है. अगर आपको
पैसे जमा करते समय या बुकिंग के समय रोके गए पेमेंट की सुविधा का इस्तेमाल करके, ऐसा किया जा सकता है
को लागू करते हैं.
यदि आप बाद में जमा राशि पर शुल्क लगाना चाहते हैं, क्योंकि टोकन केवल कुछ समय के लिए अधिकृत है, तो आपको आपके पेमेंट प्रोसेस करने वाली कंपनी के काम का एपीआई, ताकि इस टोकन को जिसे आप बाद में इस्तेमाल करने के लिए इस्तेमाल कर सकें. यह है में, पेमेंट मॉडल को चालू करने की गाइड के सेक्शन में बताया गया है डिपॉज़िट टोकन फ़्लो.
वापस लौटने पर
CreateBookingResponse
booking.payment_information
फ़ील्ड के लिए ज़रूरी है
नीचे दिए गए उदाहरण की तरह, जमा की गई स्थिति को सही तरीके से इको करें.
JSON
{ "prepayment_status": "PREPAYMENT_PROVIDED", "payment_processed_by": "PROCESSED_BY_PARTNER", "payment_transaction_id": "[this-transaction-id]", "price": { "price_micros": "200000000", "currency_code": "USD" } "deposit": { "deposit": { "price_micros": 25000000, "currency_code": USD, "min_advance_cancellation_sec": 28800, } "deposit_type": "FIXED_RATE_DEFAULT" } }
ध्यान दें कि जमा को इस तरह से सेट किया गया है कि वह
लिया जाना चाहिए या रोका गया हो. यह भी ध्यान रखें कि,
पहले पेमेंट का उदाहरण: इस मैसेज में transaction_id
होना ज़रूरी है.
रीयल-टाइम अपडेट
अगर कोई उपयोगकर्ता डिपॉज़िट रद्द करने की समयसीमा से पहले अपनी बुकिंग रद्द कर देता है, तो आपको आपको उपयोगकर्ता के कार्ड से काटे गए पैसे का रिफ़ंड करना होगा. टास्क कब शुरू होगा जमा करते समय रिफ़ंड करते हैं, तो आपको रीयल-टाइम अपडेट, जिसमें यह बताया जाता है कि पैसे रिफ़ंड कर दिए गए हैं.
इन खातों से बनाई गई बुकिंग के लिए
CreateBooking
, अपडेट इस ईमेल पते पर भेजा जाना चाहिए
notification.partners.bookings.patch
. इसके मुख्य भाग में
अनुरोध, अपडेट की गई बुकिंग होना चाहिए और उसकी स्थिति
CANCELED
और
paymentInformation.prepaymentStatus
फ़ील्ड को इस पर सेट किया गया
PREPAYMENT_REFUNDED
. इससे Google को पता चलता है कि
रिफ़ंड किया गया.
उदाहरण के लिए, अनुरोध यहां भेजा जा सकता है:
PATCH https://mapsbooking.googleapis.com/v1alpha/notification/partners/12345678/bookings/123123123?updateMask=status
अनुरोध के मुख्य हिस्से के साथ:
JSON
{ "name": "partners/12345678/bookings/123123123" "merchantId": "merchant-1" "serviceId": "service-2-b" "status": "CANCELED" "paymentInformation": { "prepaymentStatus": "PREPAYMENT_REFUNDED" } }
क्रेडिट कार्ड ज़रूरी है
किसी सेवा का इस्तेमाल करने के लिए, आपको क्रेडिट कार्ड की ज़रूरत पड़ सकती है. उपयोगकर्ता की पहचान की पुष्टि करना. हालांकि, इसका इस्तेमाल नहीं किया जाना चाहिए ऐडवांस पेमेंट, डिपॉज़िट या कोई शो न होने पर लगने वाला शुल्क. अगर ऊपर बताई गई बातों को आवश्यक है, तो उन्हें इन चरणों का उपयोग करके स्पष्ट रूप से कॉन्फ़िगर किया जाना चाहिए पढ़ें. कृपया यह भी ध्यान रखें कि क्रेडिट कार्ड की आवश्यकता होने पर अक्सर इस सेवा के लिए बुकिंग में काफ़ी गिरावट आई है.
चेकआउट के दौरान क्रेडिट कार्ड दिया जाना ज़रूरी बनाने के लिए, आपको
require_credit_card
फ़ील्ड को
REQUIRE_CREDIT_CARD_ALWAYS
.
JSON
{ "merchant_id": "merchant-1", "service_id": "service-1-a", "name": "Men's haircut", "description": "One of our stylists will cut your hair", "price": { "price_micros": 15000000, "currency_code": "USD" }, "require_credit_card": "REQUIRE_CREDIT_CARD_ALWAYS" }
बुकिंग सर्वर
अगर किसी अनुरोध में क्रेडिट कार्ड से जुड़ी कोई शर्त शामिल है, तो उसे प्रोसेस करने के लिए पेमेंट करना होगा
टोकन को इस कॉल में आपके बुकिंग सर्वर को पास किया जाता है
फ़ील्ड के ज़रिए CreateBooking
payment_processing_parameters.unparsed_payment_method_token
.
यह टोकन उसी तरीके से पास किया जाता है जैसे ऐडवांस में किया जाता है
केस. हालांकि, टोकन को कुछ समय के लिए ही इस्तेमाल किया जा सकता है
समय की, आपको अपने भुगतान प्रोसेसर के प्रासंगिक API को कॉल करना होगा
इस टोकन को ऐसे वर्शन में अपग्रेड करें जिसे आप
बाद में बंद कर सकते हैं.
बुकिंग सर्वर के जवाब में, कोई और जानकारी देने की ज़रूरत नहीं है पेमेंट पर पहुंचने के बाद इस्तेमाल के लिए उपलब्ध होती है.
खरीदारी के लिए उपलब्धता के लेवल पर कीमत बदलना
ऊपर दिए गए सभी उदाहरणों में, कीमत / शुल्क का स्ट्रक्चर बताया गया है तक सीमित नहीं हो सकता. ज़्यादातर मामलों में, सेवा स्तर की यह कीमत इतनी होनी चाहिए इस्तेमाल किया गया. हालांकि, कुछ मामलों में पेमेंट के स्ट्रक्चर में बदलाव करना सही रहता है कुछ उपलब्धता स्लॉट के लिए. उदाहरण के लिए, नीचे दी गई स्थितियों में को उपलब्धता के लेवल पर कीमतों / शुल्कों में बदलाव करके ऐसा किया जा सकता है:
- मंगलवार को किराया कम होता है और शनिवार को बढ़ता है.
- शाम 5 बजे से 7 बजे के बीच उपलब्ध होने पर, शो का कोई शुल्क नहीं लगेगा.
नीचे दी गई टेबल में यह बताया गया है कि पेमेंट / शुल्क के हर तरीके के लिए, आपको कौनसा फ़ील्ड सेवा स्तर की परिभाषा को बदलने के लिए उपलब्धता फ़ीड में इस्तेमाल करें.
पैसे चुकाने का तरीका | शुल्क / कीमत की परिभाषा | ओवरराइड किया जा सकता है? |
---|---|---|
पहुंचने पर पेमेंट करें | Service.price
|
मूल्य को इसके ज़रिए बदला जा सकता है
Availability.payment_option_id का रेफ़रंस देना
Merchant.payment_option
|
पूर्व-भुगतान | Service.price
|
मूल्य को इसके माध्यम से बदला जा सकता है
Availability.payment_option_id का रेफ़रंस देना
Merchant.payment_option
|
न पहुंचने का शुल्क | Service.no_show_fee
|
Availability.no_show_fee
|
जमा | Service.deposit
|
Availability.deposit
|
क्रेडिट कार्ड ज़रूरी है | Service.require_credit_card
|
Availability.require_credit_card
|
ध्यान दें कि उपलब्धता के स्तर पर कीमत बदलने के लिए, आपको सबसे पहले व्यापारी/कंपनी/कारोबारी के लेवल पर पेमेंट का विकल्प दिया गया हो. साथ ही, उपलब्धता लेवल पर अपॉइंटमेंट रद्द करने की समयसीमा सेट करने का अनुरोध किया जा सकता है. कृपया गाइड देखें रद्द करने की विंडो जोड़ने का तरीका.