Gratuidade

Quando um cliente finaliza a compra, a opção "Pedido completo" mostra um seletor de gorjetas. Isso permite que o cliente escolha a quantidade de gratificação que será incluída no pedido.

A ordenação de ponta a ponta envia o valor escolhido em SubmitOrderRequestMessage como uma LineItem do tipo GRATUITY dentro de um ProposedOrder.otherItem.

Como ocultar o seletor de gorjetas

Para ocultar o seletor de gorjetas de um serviço de restaurante, use o ServingConfig.disableTipWidget nos feeds de dados de inventário.

Como definir um valor de gratificação padrão

Você pode definir um valor de gratificação padrão ou se recusar a aceitar a gratificação de um restaurante durante a finalização da compra. Os casos de uso abaixo têm suporte no CheckoutResponseMessage:

  • Um restaurante exige um valor fixo de gorjeta

    No ProposedOrder.otherItems em CheckoutResponseMessage, adicione um item de linha do tipo GRATUITY com um valor fixo dentro.

    JSON

    {
      "name": "Required Tip",
      "type": "GRATUITY",
      "price": {
        "type": "ESTIMATE",
        "amount": {
          "currencyCode": "USD",
          "units": "3",
          "nanos": 100000000
        }
      },
      "gratuityExtension": {
        "gratuityType": "MANDATORY"
      }
    }
    
  • Um restaurante sugere um brinde e dá ao cliente a opção de mudar o valor

    No ProposedOrder.otherItems no CheckoutResponseMessage, adicione um item de linha do tipo GRATUITY com um valor fixo. Adicione também gratuityExtension com um valor gratuityType de USER_MODIFIABLE.

    JSON

    {
      "name": "Suggested Tip",
      "type": "GRATUITY",
      "price": {
        "type": "ESTIMATE",
        "amount": {
          "currencyCode": "USD",
          "units": "3",
          "nanos": 100000000
        }
      },
      "gratuityExtension": {
        "gratuityType": "USER_MODIFIABLE"
      }
    }
    
  • Um restaurante não aceita gratuidades

    No ProposedOrder.otherItems em CheckoutResponseMessage, adicione um item de linha do tipo GRATUITY com um valor em branco dentro.

    JSON

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