غرائب

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

يرسل الطلب الشامل المبلغ المحدد 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 بقيمة gratuityType قيمتها USER_MODIFIABLE.

    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"
    }
  }
}