تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

تفعيل الدفعات

كجزء من عملية "الحجز مع الدمج الكامل" من Google، يمكنك تفعيل التجّار لتلقّي الدفعات من المستخدمين عند إجراء الحجز أو تحديد الموعد أو إجراء الحجز. تعمل Google مع الجهات المسؤولة عن معالجة المعاملات لإعداد الرموز المميّزة. وتستخدم الجهات المسؤولة عن معالجة المعاملات رموزًا مميّزة فريدة للدفع للتجّار بأمان.

بالنسبة إلى الحجوزات الآمنة للدفع، نعرض وحدة معلومات الدفع أثناء عملية الدفع. يسمح هذا للمستخدم بإدخال معلومات بطاقة الائتمان.

يتوفر دعم لـ 3DS1 و3DS2، يُرجى الرجوع إلى هذا البرنامج التعليمي حول التنفيذ.

الأهلية

لكي يستوفي التجّار الدفعات من خلال ميزة "الحجز عبر Google"، يجب أن تستوفي المتطلبات التالية:

استخدام معالج دفع معتمد يمكنك العثور على أحدث قائمة بالمعالجات المتوافقة على موقع 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.

حالات الاستخدام للدفعات

عند تحديد ما إذا كنت تريد تلقي دفعات في كل حالة من حالات الاستخدام هذه، يُرجى مراجعة سياسات الدفعات والتأكد من قدرتك على الالتزام بجميع السياسات ذات الصلة.

هناك حالات استخدام لعمليات الدفع:

للحصول على مزيد من المعلومات حول كيفية تنفيذ كل من حالات الاستخدام هذه، يمكنك الاطّلاع على البرنامج التعليمي حول ضبط Payments.

إكمال الحجوزات المدفوعة مسبقًا

يوضح الشكل 1 تدفق الأنشطة بين المستخدمين، وأنت (شريك الجدولة) وGoogle ومعالج الدفع.

الرسم 1: الرسم البياني لتسلسل الحجوزات المدفوعة مسبقًا — **الشكل 1:** الرسم البياني لتسلسل الحجوزات المدفوعة مسبقًا

يجب أن تكون الدفعة 100% من مبلغ تكلفة الخدمة. بمعنى آخر، يجب أن تُدفَع الخدمات كاملةً في وقت الحجز.

تغييرات في خلاصات الخدمات

اضبط الحقل prepayment_type على REQUIRED لهذه الخدمة.
اضبط الحقل require_credit_card على REQUIRE_CREDIT_CARD_CONDITIONAL لتلك الخدمة.

الودائع ورسوم عدم الحضور

يتم إعداد الودائع ورسوم عدم الحضور بطرق مشابهة. يوضح الشكل 2 تدفق هذه الأنشطة بين المستخدمين، وأنت (شريك الجدولة) وGoogle ومعالج الدفع.

الرسم 2: رسم بياني لتسلسل حجوزات الرسوم أو عدم عرضها — **الشكل 2:** رسم بياني لتسلسل الحجوزات والإيداعات أو عدم العرض

ويمكن استخدام رسوم الودائع ورسوم عدم الحضور لضمان وصول المستخدم إلى حجزه.

يمكن تحصيل رسوم الإيداع من بطاقة ائتمان المستخدم مقدمًا أو في وقت لاحق.
ويمكن أن يحصّل المستخدم رسوم عدم الحضور إذا لم يظهر في الحجز.
إذا لزم الأمر، يمكن تطبيق كل من الإيداعات ورسوم عدم الحضور معًا للحجز.
حتى إذا لم تكن هناك دفعة مطلوبة مقدمًا، يجب أن يستجيب خادم الحجز إلى طلب 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 على مستوى الخدمة أو على مستوى شريحة مدى التوفّر للتاجر.

الإلغاء ورد الأموال

تبدأ عمليات الإلغاء وعمليات ردّ الأموال من قِبل الشريك (أنت) أو من قِبل المستخدم من خلال ميزة "الحجز عبر Google". وفي كلتا الحالتين، عليك الالتزام بقيم CancellationPolicy التي تم ضبطها على مستوى الخدمة وإعلام المستخدم عند إتمام الدفع.

إذا لم تقدّم CancellationPolicy، من المفترض أن يكون أي عملية إلغاء خلال الفترة التي حدّدتها min_advance_online_canceling والتي تم ضبطها على مستوى الخدمة قابلة للاسترداد. إذا لم يتم تحديد min_advance_online_canceling فهي 0 (بمعنى أنها قابلة للإلغاء في أي وقت).

إذا كان عليك إيقاف ميزة "إلغاء الحجز" من جهة "الحجز عبر Google"، يُرجى مناقشة الأمر مع جهة اتصال عمليات الشركاء (POC) في Google.

إجراء تغييرات على وحدات النقل في الوقت الفعلي

بعد ردّ الأموال إلى المستخدم، عليك إرسال تعديل على الوقت الفعلي للرحلة من أجل تغيير حالة الدفع للحجز. اضبط update_mask على status,payment_information.prepayment_status واضبط payment_information.prepayment_status = PREPAYMENT_REFUNDED وstatus = CANCELED.
- استخدِم السمتَين BookingStatus = CANCELED وPrepaymentStatus = PREPAYMENT_REFUNDED الجديدتَين. قيمة التعداد CANCELED_AUTOMATIC_REFUND غير مفعّلة لكل من واجهة برمجة تطبيقات الحجز في "خرائط Google" ونماذج gRPC.

تغيير إلى خادم الحجز

عندما ترسل ميزة "الحجز عبر Google" UpdateBookingRequest ويؤدي ذلك إلى ردّ أموال المستخدم، اضبط booking.payment_information.prepayment_status = PREPAYMENT_REFUNDED في UpdateBookingResponse.