小费

客户结账时，端到端订餐会显示小费选择器。这样，客户就可以选择要将多少小费包含在订单中。

端到端订餐会将 SubmitOrderRequestMessage 中选择的金额作为类型为 GRATUITY 的 LineItem 发送到 ProposedOrder.otherItem 中。

如何隐藏小费选择器

您可以在商品目录数据 Feed 中使用 ServingConfig.disableTipWidget 隐藏餐厅服务的小费选择器。

如何设置默认的小费金额

您可以在结账时为餐厅设置默认的小费金额或拒绝接受小费。CheckoutResponseMessage 中可以支持以下用例：

  • 餐厅要求收取固定的小费

    在 CheckoutResponseMessage 内的 ProposedOrder.otherItems 中，添加一个类型为 GRATUITY 且包含固定金额的订单项。

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

  • 餐厅建议小费金额，并让客户可以选择修改金额

    在 CheckoutResponseMessage 内的 ProposedOrder.otherItems 中，添加一个金额固定的 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"
  }
}

  • 餐厅不接受任何小费

    在 CheckoutResponseMessage 内的 ProposedOrder.otherItems 中，添加一个类型为 GRATUITY 且金额为空的订单项。

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