Mancia

Quando un cliente effettua il pagamento, Ordine end-to-end mostra un selettore di mancia. In questo modo, il cliente può scegliere l'importo della mancia da includere nell'ordine.

Ordine end-to-end invia l'importo scelto in SubmitOrderRequestMessage come LineItem di tipo GRATUITY all'interno di un ProposedOrder.otherItem.

Come nascondere il selettore di suggerimenti

Puoi nascondere il selettore della mancia per un servizio di ristorante utilizzando il valore ServingConfig.disableTipWidget nei feed di dati di inventario.

Come impostare un importo predefinito per la mancia

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

  • Un ristorante richiede un importo fisso per la mancia

    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 modificarne 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 con un importo vuoto al suo interno.

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