كجزء من الدمج الشامل للحجوزات في "مركز الإجراءات"، يمكنك السماح للتجّار بتلقّي الدفعات من المستخدمين عند إجراء حجز أو موعد أو حجز. تتعاون 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
.