免费

当客户结账时,“端到端订购”功能会显示一个小费选择器。这样,客户就可以选择订单中包含的小费。

端到端订购会将 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 且具有固定金额的订单项。此外,请务必添加 gratuityType 值为 USER_MODIFIABLEgratuityExtension

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