Gratuity

Gdy klient dokonuje płatności, kompleksowa pomoc w zamawianiu wyświetla selektor napiwków. Dzięki temu klient może wybrać kwotę napiwku, którą chce dodać do zamówienia.

Kompleksowa pomoc w zamawianiu wysyła wybraną kwotę w SubmitOrderRequestMessage jako LineItem typu GRATUITY w ramach elementu ProposedOrder.otherItem.

Jak ukryć selektor napiwków

Możesz ukryć selektor napiwków w przypadku usługi restauracji, korzystając z ServingConfig.disableTipWidgetw plikach danych o asortymencie.

Jak ustawić domyślną kwotę napiwku

Podczas płatności możesz ustawić domyślną kwotę napiwku lub odmówić przyjęcia napiwku za restaurację. W ramach CheckoutResponseMessage można obsługiwać te przypadki użycia:

  • Restauracja wymaga uiszczenia napiwku w konkretnej kwocie

    W sekcji ProposedOrder.otherItems w grupie CheckoutResponseMessage dodaj element zamówienia typu GRATUITY z ustaloną kwotą.

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

  • Restauracja sugeruje napiwek i daje klientowi możliwość zmiany jego kwoty

    W sekcji ProposedOrder.otherItems w ramach sekcji CheckoutResponseMessage dodaj element zamówienia typu GRATUITY o stałej kwocie. Pamiętaj też o dodaniu właściwości gratuityExtension z wartością gratuityType USER_MODIFIABLE.

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

  • Restauracja nie akceptuje napiwków

    W wierszu ProposedOrder.otherItems w sekcji CheckoutResponseMessage dodaj element zamówienia typu GRATUITY z pustą kwotą.

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