كجزء من الدمج الشامل للمواعيد في "مركز الإجراءات"، يمكنك السماح للتجّار الذين تتعامل معهم بتلقّي الدفعات من المستخدمين عند إجراء حجز أو موعد أو حجز. تتعاون Google مع الجهات المسؤولة عن معالجة المعاملات لإعداد الرموز المميّزة. تستخدم الجهات المسؤولة عن معالجة المعاملات بعد ذلك رموزًا مميّزة فريدة لتسديد الدفعات بأمان للتجّار.
بالنسبة إلى الحجوزات الآمنة من خلال الدفع، نعرض وحدة معلومات الدفع في مسار الدفع. يتيح ذلك للمستخدم إدخال معلومات بطاقة الائتمان.
يتوفّر دعم النموذجَين 3DS1 و3DS2. يُرجى مراجعة هذا البرنامج التعليمي حول عملية التنفيذ.
الأهلية
لكي يتلقّى التجّار الدفعات من خلال "مركز الإجراءات"، يجب استيفاء المتطلبات التالية:
- استخدام جهة مسؤولة عن معالجة المعاملات معتمدة يمكن العثور على أحدث قائمة بالمعالجات المتوافقة على موقع Google Pay الإلكتروني.
- اقبل الدفعات المحوَّلة إلى رموز مميّزة وفقًا للمعالج الذي تتعامل معه.
- أكمِل عملية إثبات الهوية والنشاط التجاري الموضحة هنا.
- لا يمكن تفعيل الدفع للحجوزات التي تتطلب تأكيد غير متزامن .
تغييرات في الخلاصات وخادم الحجز للدفعات
يتم تسديد الدفعات من خلال عملية موافقة على مستوى التاجر. يجب تفعيل الدفعات لأي تاجر يحتاج إلى استلام دفعة مقابل أي من خدماته. لتفعيل عمليات الدفع، يجب إجراء تغييرات على الخلاصات وعلى خادم الحجز.
الخلاصات
- خلاصة التاجر: حدِّد معلومات الدفع من خلال السمة
tokenization_parameterالتي تم ضبطها في الحقلtokenization_config. وتعتمد المجموعة على الجهة المسؤولة عن معالجة المعاملات التي تم اختيارها. المجموعة هي مجموعةpaymentMethodTokenizationParameters.parametersنفسها التي سيتم إرسالها إلى Google Pay إذا أردت الدمج معها. - خلاصات الخدمات/التوافر: حدد متطلبات الدفع بناءً على حالة الاستخدام المناسبة. لمزيد من التفاصيل، راجِع حالات الاستخدام للدفعات.
خادم الحجز
- تنفيذ
طريقة
CreateBookingاستنادًا إلى نوع الدفعات التي يسدّدها المستخدمون - سترسل Google الرموز المميّزة للدفع في الحقل
payment_processing_parameters.unparsed_payment_method_tokenكجزء منCreateBookingRequest. هذه هي قيمةpaymentDataنفسها التي سيتلقّاها معاودة الاتصال بك في عملية دمج مع Google Pay. - في
CreateBookingResponse، يمكنك تضمين رسالة PaymentInformation التي تحدِّد نوع الدفع والحالة ومعرِّف المعاملة وبنية السعر / الرسوم. - اضبط الحقل
payment_information.payment_processed_byعلىPROCESSED_BY_PARTNERفيCreateBookingResponse.
حالات الاستخدام لتسديد الدفعات
عند تحديد ما إذا كنت تريد تلقّي دفعات لكل حالة من حالات الاستخدام هذه، يُرجى مراجعة سياسات الدفع والتأكد من قدرتك على الالتزام بجميع السياسات ذات الصلة.
هناك حالات استخدام للدفعات:
- إكمال حجوزات مسبقة الدفع
- الإيداعات المطلوبة للحجز
- رسوم عدم الحضور في حال عدم حضور المستخدم في الحجز
- بطاقة ائتمان مطلوبة لإجراء الحجز
للحصول على مزيد من المعلومات حول كيفية تنفيذ كل حالة من حالات الاستخدام هذه، يُرجى الاطّلاع على البرنامج التعليمي حول إعداد عمليات الدفع.
إكمال حجوزات مسبقة الدفع
يوضّح الشكل 1 تدفق الأنشطة بين المستخدمين، وبينك (شريك الجدولة)، وGoogle، والجهة المسؤولة عن معالجة المعاملات.
- يجب أن تصل قيمة الدفعة إلى 100% من مبلغ تكلفة الخدمة. بعبارة أخرى، يجب دفع رسوم الخدمات بالكامل في وقت الحجز.
-
اضبط الحقل
prepayment_typeعلىREQUIREDلهذه الخدمة. - اضبط الحقل
require_credit_cardعلىREQUIRE_CREDIT_CARD_CONDITIONALلهذه الخدمة.
الإيداعات ورسوم عدم الحضور
ويتم تحديد الإيداعات ورسوم عدم الحضور بطرق مماثلة. ويوضّح الشكل 2 سير هذه الأنشطة بين المستخدمين، وبينك (شريك الجدولة)، وGoogle، والجهة المسؤولة عن معالجة المعاملات.
يمكن استخدام الإيداعات ورسوم عدم الحضور لضمان حضور المستخدم في الحجز.
- يمكن إيداع المبلغ من بطاقة ائتمان المستخدم إما مقدّمًا أو في وقت لاحق.
- يمكن أن يتم تحصيل رسوم عدم الحضور من المستخدم في حال عدم الحضور في الحجز.
- عند الضرورة، يمكن إيداع رسوم عدم الحضور وإيداعها معًا للحجز.
- حتى إذا لم يُطلب منك دفع أي مبلغ مقدّمًا، يجب أن
يردّ خادم الحجز على طلب CreateBooking من خلال إرسال
PaymentInformationيحتوي علىpayment_transaction_id، ويجب أن يكون هذا الطلب فريدًا. ولا تحتاج إلى تقديمpayment_transaction_idمن قِبل الجهة المسؤولة عن معالجة المعاملات، ولكن يمكن أن ينشئها خادم الحجز بدلاً من ذلك.
يمكن تحديد الإيداعات ورسوم عدم الحضور على مستوى الخدمة أو على مستوى خانة مدى التوفّر للتاجر. وفي حال تحديدها على مستوى خانة مدى التوفّر، سيتم إلغاء تعريفات مستوى الخدمة.
- لتفعيل الإيداعات، اضبط الحقل
depositعلى مستوى الخدمة أو خانة التوفّر. - لتفعيل ميزة عدم الحضور، اضبط الحقل
no_show_feeعلى مستوى خانة الخدمة أو مدى التوفّر. - اضبط الحقل
require_credit_cardعلىREQUIRE_CREDIT_CARD_CONDITIONALعلى مستوى خانة الخدمة أو مدى التوفّر. - (اختياري) اضبط السمة
prepayment_typeعلىREQUIREDأوOPTIONAL.
بطاقة الائتمان مطلوبة
وقد تكون هناك حالات استخدام أخرى تتطلّب استخدام بطاقة ائتمان في وقت الحجز.
- اضبط الحقل
require_credit_cardعلىREQUIRE_CREDIT_CARD_ALWAYSعلى مستوى الخدمة أو على مستوى خانة مدى التوفّر للتاجر.
الإلغاء وردّ الأموال
يتولى الشريك (أنت) أو المستخدم إجراء عمليات الإلغاء وردّ الأموال من خلال "مركز الإجراءات". وفي كلتا الحالتين، عليك الالتزام بما ورد في
CancellationPolicy
الذي تم ضبطه على مستوى الخدمة
وإعلام المستخدم به عند إتمام الدفع.
في حال عدم تقديم السمة
CancellationPolicy،
من المفترض أن تكون أي عملية إلغاء خلال فترة الإلغاء المحدّدة في
min_advance_online_canceling ويمكن استردادها على
مستوى الخدمة.
إذا لم يتم تحديد قيمة السمة min_advance_online_canceling، تكون القيمة 0 (بمعنى قابل للإلغاء في أي وقت).
إذا كان عليك إيقاف الإلغاء من جانب "مركز الإجراءات"، يُرجى مناقشة الأمر مع جهة التواصل التي تتعامل معها في Google.
التغييرات على مُدد النقل- بعد ردّ الأموال إلى المستخدم، عليك إرسال
تعديل RTU للحجز لتغيير حالة الدفع
للحجز. اضبط
update_maskعلىstatus,payment_information.prepayment_statusواضبطpayment_information.prepayment_status = PREPAYMENT_REFUNDEDوstatus = CANCELED.- يمكنك استخدام السمتَين
BookingStatus = CANCELEDوPrepaymentStatus = PREPAYMENT_REFUNDEDالجديدتَين. تم إيقاف قيمة التعدادCANCELED_AUTOMATIC_REFUNDنهائيًا في كلّ من نماذج Maps Booking API وgRPC.
- يمكنك استخدام السمتَين
- عندما يرسل "مركز الإجراءات" رمز
UpdateBookingRequestويؤدي ذلك إلى ردّ أموال المستخدم، اضبطbooking.payment_information.prepayment_status = PREPAYMENT_REFUNDEDفيUpdateBookingResponse.