نظرة عامة

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

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

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

الأهلية

لكي يتلقّى التجّار الدفعات من خلال "مركز الإجراءات"، يجب استيفاء المتطلبات التالية:

1. استخدام خدمة معالجة دفعات متوافقة يمكنك الاطّلاع على أحدث قائمة بالمعالِجات المتوافقة على موقع Google Pay الإلكتروني.
2. قبول الدفعات الرمزية وفقًا لجهة معالجة المعاملات
3. أكمِل عملية إثبات الهوية والنشاط التجاري الموضّحة هنا.
4. لا يمكن تفعيل الدفع للحجوزات التي تتطلّب تأكيدًا غير متزامن .

تغييرات على الخلاصات وخادم الحجز للدفعات

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

الخلاصات

• خلاصة التاجر: حدِّد معلومات الدفع من خلال مجموعة 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.

التغييرات على وحدات التحكّم في الحرارة

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

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

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