غرائب

عند إتمام العميل عملية الدفع، تعرض ميزة "الطلب الشامل" أداة اختيار النصائح. يتيح هذا للعميل اختيار مقدار الإكرامية الذي تريد تضمينه في طلبه.

يؤدي "الطلب الشامل إلى النهاية" إلى إرسال المبلغ المحدّد في SubmitOrderRequestMessage على شكل LineItem من النوع GRATUITY داخل ProposedOrder.otherItem.

كيفية إخفاء أداة اختيار النصائح

يمكنك إخفاء أداة اختيار النصائح لخدمة مطعم باستخدام ServingConfig.disableTipWidget في خلاصات بيانات المستودع.

كيفية ضبط مبلغ إكرامية تلقائي

يمكنك تعيين مبلغ الإكرامية الافتراضي أو رفض قبول الإكرامية لمطعم أثناء الدفع. يمكن إتاحة حالات الاستخدام التالية في CheckoutResponseMessage:

  • يتطلّب المطعم مبلغ إكرامية ثابت

    في ProposedOrder.otherItems ضمن CheckoutResponseMessage، أضف عنصرًا من النوع GRATUITY يحتوي على مبلغ ثابت بداخله.

    تنسيق JSON

    {
  "name": "Required Tip",
  "type": "GRATUITY",
  "price": {
    "type": "ESTIMATE",
    "amount": {
      "currencyCode": "USD",
      "units": "3",
      "nanos": 100000000
    }
  },
  "gratuityExtension": {
    "gratuityType": "MANDATORY"
  }
}

  • يقترح أحد المطاعم مكافأة ويتيح للعميل خيار تعديل المبلغ

    في ProposedOrder.otherItems ضمن CheckoutResponseMessage، أضِف عنصرًا من النوع GRATUITY بمبلغ ثابت. تأكَّد أيضًا من إضافة السمة gratuityExtension باستخدام القيمة USER_MODIFIABLE التي تبلغ gratuityType.

    تنسيق JSON

    {
  "name": "Suggested Tip",
  "type": "GRATUITY",
  "price": {
    "type": "ESTIMATE",
    "amount": {
      "currencyCode": "USD",
      "units": "3",
      "nanos": 100000000
    }
  },
  "gratuityExtension": {
    "gratuityType": "USER_MODIFIABLE"
  }
}

  • المطعم لا يقبل أي إكرامية

    في ProposedOrder.otherItems ضمن CheckoutResponseMessage، أضف عنصرًا من النوع GRATUITY مع ترك مساحة فارغة بداخله.

    تنسيق JSON

    {
  "name": "Tip",
  "type": "GRATUITY",
  "price": {
      "type":"ESTIMATE",
      "amount": {
        "currencyCode":"USD"
    }
  }
}