تحديد أنواع الدفع

المتطلبات الأساسية

لإكمال هذا الدليل، يجب أن تكون قد أكملت ما يلي:

1. فهم سياسات الدفع
2. أكملت قسم تصدير الخلاصات من دمج E2E.

في ما يلي طرق الدفع المتوافقة مع هذه الإضافة:

1. دفع مقدم
2. لا رسوم للعرض / رسوم الإلغاء
3. Deposit
4. يجب توفير بطاقة ائتمان

جميع حالات الاستخدام للدفعات هي إضافات لحالات الاستخدام "عدم الدفع / الدفع عند الوصول" (التي لا تتطلّب أي إعداد للدفع)، لذا سيبدأ هذا البرنامج التعليمي بوصف تلك الإعدادات والتعامل مع الإعدادات الأخرى على أنّها إضافات.

دفع مقدم

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

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

{
  "availability": [{
    "merchant_id": "dining-A",
    "service_id": "reservation",
    "start_sec": 1535853600,
    "duration_sec": 2700,
    "spots_total": 2,
    "spots_open": 2,
    "resources": {
    "room_id": "A-dining-room",
    "room_name": "Wine Tasting Room",
    "party_size": 2,
    "prepayment": {
      "price_info": {
        "price": {
          "price_micros": 200000000,
          "currency_code": "USD",
          },
        "price_type": "PER_PERSON"
        }
      }
    }
  }]
}

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

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

لتحديد رسوم عدم العرض، يجب تضمين الحقل no_show_fee في خلاصة الخدمة كما هو موضّح في المثال التالي:

{
    "merchant_id": "merchant-1",
    "service_id": "service-2-b",
    "name": "Reservation",
    "description": "A dining reservation",
    "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 ساعات (14400 ثانية) قبل الموعد، كما هو محدّد في حقل scheduling_rules.min_advance_online_canceling.

لمعرفة كيفية تحديد عدم ظهور رسوم العرض في خلاصة مدى التوفّر، يُرجى مراجعة إلغاء التسعير على مستوى مدى التوفّر.

يمكن بشكل اختياري ضبط إعدادات عدم الحضور التي تُفرض على كل شخص مقابل الحجز. وفي هذه الحالة، يمكن ضبط السمة no_show_fee.fee.fee_type على السمة PER_PERSON.

Deposit

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

لتحديد إيداع، يجب تضمين الحقل deposit في خلاصة الخدمة كما هو موضّح في المثال التالي:

{
    "merchant_id": "merchant-1",
    "service_id": "service-2-b",
    "name": "Reservation",
    "description": "A dining reservation",
    "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 ساعة (86400 ثانية). بهذه الطريقة، سيتم إعلام التاجر بشكل مباشر بحالات الإلغاء المتأخرة. مع ذلك، قد يبقى المستخدم مؤهلاً لاسترداد الأموال التي دفعها مقابل الإيداع قبل 4 ساعات (أي 14400 ثانية) قبل الحجز (من خلال التواصل معك أو مع التاجر لإلغاء الحجز)، وستظهر البنود في البنود عند الدفع وفي رسالة التأكيد الإلكترونية.

لمعرفة كيفية تحديد الإيداعات على مستوى التوفر، راجع تجاوز التسعير على مستوى التوفر.

يُرجى العِلم أيضًا أنّه يمكن إيداع مبلغ بقيمة ثابتة أو مقابل سعر خاص بالشخص، مثل رسوم عدم الحضور. في هذه الحالة، يكون الإيداع بسعر ثابت قدره 25 دولار أمريكي (أو ما يعادله بالعملة المحلية)، على النحو المحدّد في "deposit_type": "FIXED_RATE_DEFAULT". وإذا كان الحجز يشمل حجم الحفل، يمكن تحديد الإيداع كإيداع لكل شخص من خلال ضبط "deposit_type": "PER_PERSON".

طلب بطاقة ائتمان

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

لطلب تقديم بطاقة ائتمان أثناء الدفع، يجب ضبط الحقل require_credit_card على REQUIRE_CREDIT_CARD_ALWAYS.

{
    "merchant_id": "merchant-1",
    "service_id": "reservation",
    "name": "reservation",
    "description": "Food reservation",
    "require_credit_card": "REQUIRE_CREDIT_CARD_ALWAYS"
}

إلغاء السعر على مستوى مدى التوفّر

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

• تنخفض الأسعار أيام الثلاثاء وترتفع أيام السبت.
• لا تنطبق رسوم على مدى التوفّر بين الساعة 5:00 مساءً و7:00 مساءً.
• اطلب الإيداعات لأحجام الحفلات الأكبر من 6.
• تتطلّب الحجوزات في غرفة معيّنة بطاقة ائتمان.

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

نوع الدفع	تعريف الخلاصة	هل يمكن تجاوزها؟
دفع مقدم	Availability.prepayment	لا يمكن تجاوزه
لا تُفرَض رسوم على المشاركة.	Service.no_show_fee	Availability.no_show_fee
Deposit	Service.deposit	Availability.deposit