Tiền thưởng

Khi khách hàng thanh toán, tính năng Đặt hàng hoàn chỉnh sẽ hiển thị bộ chọn tiền boa. Điều này cho phép khách hàng chọn số tiền thưởng để thêm vào đơn đặt hàng.

Dịch vụ Đặt hàng hai đầu sẽ gửi số tiền đã chọn SubmitOrderRequestMessage với tư cách là LineItem trong số nhập GRATUITY bên trong một ProposedOrder.otherItem.

Cách ẩn bộ chọn tiền boa

Bạn có thể ẩn bộ chọn tiền boa cho một dịch vụ nhà hàng bằng cách sử dụng ServingConfig.disableTipWidget trong nguồn cấp dữ liệu kho hàng của bạn.

Cách đặt số tiền thưởng mặc định

Bạn có thể đặt số tiền thưởng mặc định hoặc từ chối chấp nhận tiền thưởng cho của nhà hàng trong quá trình thanh toán. Các trường hợp sử dụng sau đây có thể được hỗ trợ trong CheckoutResponseMessage:

  • Nhà hàng yêu cầu số tiền thưởng cố định

    Trong ProposedOrder.otherItems trong CheckoutResponseMessage, hãy thêm một mục hàng thuộc loại GRATUITY có số tiền cố định bên trong.

    JSON

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

  • Một nhà hàng đề xuất tặng tiền thưởng và cho khách hàng lựa chọn sửa đổi số tiền

    Trong ProposedOrder.otherItems trong CheckoutResponseMessage, hãy thêm một mục hàng thuộc loại GRATUITY với số tiền cố định. Hãy nhớ thêm gratuityExtension có giá trị gratuityType là USER_MODIFIABLE.

    JSON

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

  • Nhà hàng không nhận tiền thưởng

    Trong ProposedOrder.otherItems thuộc CheckoutResponseMessage, thêm mục hàng thuộc loại GRATUITY có số lượng trống bên trong.

    JSON

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