팁

고객이 결제하면 엔드 투 엔드 순서 지정에 팁 선택기가 표시됩니다. 이를 통해 고객이 주문에 포함할 팁 금액을 선택할 수 있습니다.

엔드 투 엔드 순서 지정은 선택한 금액을 SubmitOrderRequestMessage에서 ProposedOrder.otherItem 내부의 GRATUITY 유형의 LineItem로 전송합니다.

팁 선택기를 숨기는 방법

인벤토리 데이터 피드에서 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_MODIFIABLE인 gratuityExtension도 추가해야 합니다.

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