Tiền boa

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. Thao tác này cho phép khách hàng chọn số tiền boa để thêm vào đơn đặt hàng của họ.

Tính năng Đặt hàng toàn diện sẽ gửi số lượng đã chọn trong SubmitOrderRequestMessage dưới dạng LineItem thuộc loại GRATUITY bên trong ProposedOrder.otherItem.

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

Bạn có thể ẩn bộ chọn tiền boa cho 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ách đặt số tiền boa mặc định

Bạn có thể đặt số tiền boa mặc định hoặc từ chối nhận tiền boa cho nhà hàng trong quy 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 một khoản tiền boa cố định

    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 bên trong.

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

  • Nhà hàng đề xuất tiền boa và cho phép khách hàng chỉnh sửa 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 với 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 chấp nhận tiền boa

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

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