الإكرامية

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

تُرسِل عملية الطلب الشاملة المبلغ المحدّد في 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"
    }
  }
}