Gratificação

Quando um cliente faz o checkout, o recurso Pedidos de ponta a ponta mostra um seletor de gorjeta. Isso permite que o cliente escolha o valor da gorjeta a ser incluído no pedido.

O pedido de ponta a ponta envia o valor escolhido em SubmitOrderRequestMessage como um LineItem do tipo GRATUITY dentro de um ProposedOrder.otherItem.

Como ocultar o seletor de dicas

Você pode ocultar o seletor de gorjeta para um serviço de restaurante usando o ServingConfig.disableTipWidget nos seus feeds de dados de inventário.

Como definir um valor de gorjeta padrão

Você pode definir um valor de gorjeta padrão ou recusar a gorjeta de um restaurante durante o pagamento. Os seguintes casos de uso podem ser suportados no CheckoutResponseMessage:

  • Um restaurante exige uma gorjeta fixa

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

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

    No ProposedOrder.otherItems dentro de 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 gorjeta

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

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