Gratuità

Quando un cliente effettua il pagamento, Ordine end-to-end mostra un selettore di suggerimenti. Ciò consente al cliente di scegliere l'importo della mancia da includere nell'ordine.

L'ordine end-to-end invia la quantità scelta in SubmitOrderRequestMessage come LineItem di tipo GRATUITY all'interno di ProposedOrder.otherItem.

Come nascondere il selettore dei suggerimenti

Puoi nascondere il selettore di suggerimenti per un servizio di ristorazione utilizzando ServingConfig.disableTipWidget nei feed di dati di inventario.

Come impostare un importo di mancia predefinito

Puoi impostare un importo predefinito o rifiutare di accettare la mancia per un ristorante al momento del pagamento. I seguenti casi d'uso possono essere supportati in CheckoutResponseMessage:

  • Un ristorante richiede una mancia fissa

    In ProposedOrder.otherItems all'interno di CheckoutResponseMessage, aggiungi un elemento pubblicitario di tipo GRATUITY con un importo fisso al suo interno.

    JSON

    {
      "name": "Required Tip",
      "type": "GRATUITY",
      "price": {
        "type": "ESTIMATE",
        "amount": {
          "currencyCode": "USD",
          "units": "3",
          "nanos": 100000000
        }
      },
      "gratuityExtension": {
        "gratuityType": "MANDATORY"
      }
    }
    
  • Un ristorante suggerisce una mancia e offre al cliente la possibilità di modificare l'importo

    In ProposedOrder.otherItems all'interno di CheckoutResponseMessage, aggiungi un elemento pubblicitario di tipo GRATUITY con un importo fisso. Assicurati di aggiungere anche gratuityExtension con un valore gratuityType di USER_MODIFIABLE.

    JSON

    {
      "name": "Suggested Tip",
      "type": "GRATUITY",
      "price": {
        "type": "ESTIMATE",
        "amount": {
          "currencyCode": "USD",
          "units": "3",
          "nanos": 100000000
        }
      },
      "gratuityExtension": {
        "gratuityType": "USER_MODIFIABLE"
      }
    }
    
  • Un ristorante non accetta alcuna mancia

    In ProposedOrder.otherItems all'interno di CheckoutResponseMessage, aggiungi un elemento pubblicitario di tipo GRATUITY contenente un importo vuoto.

    JSON

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