Point-of-sale icon

Gorjeta no recibo

Implemente a opção de gorjeta no recibo em combinação com a pré-autorização.

Somente quando necessário

A gorjeta no recibo é mais difícil de implementar e está sujeita a condições. Apenas implemente isso se for absolutamente necessário em sua situação.

Consulte Gorjeta para mais alternativas.

Aqui descrevemos como implementar a gorjeta no seu fluxo de pagamento, onde o cliente apresenta seu cartão pela primeira vez e fornece um PIN ou assinatura e, em seguida, escreve um valor de gorjeta no recibo e os assina. Isso significa que inicialmente o valor da transação é autorizado, mas o valor da gorjeta não é

Para aceitar a gorjeta dessa maneira e obter o valor total da sua conta, você precisa implementar a pré-autorização :

  • Faça uma solicitação de pré-autorização.
  • Se a gorjeta adicionar mais de 20% à quantidade original, ajuste a autorização aumentando a quantidade autorizada com a quantidade da gorjeta.
  • Capture o pagamento do valor final.

Observe que esta opção de gorjeta está sujeita a condições.

O ajuste de um valor pré-autorizado é suportado apenas para cartões de crédito American Express, Discover, Mastercard e Visa.

Antes de começar

Antes de implementar a gorjeta, certifique-se de:

Mantenha sua equipe informada utilizando webhooks

Enquanto seu cliente estiver interagindo com o terminal, você poderá apresentar mensagens de progresso em sua caixa registradora. Isso pode manter sua equipe informada sobre o valor da gorjeta.

Essas mensagens são entregues usando notificações de exibição, que são webhooks enviadas para um terminal especificado por você. Para obter informações sobre como configurar e usar as notificações de exibição, consulte nossa documentação de notificações de exibição.

Etapa 1: Pré-autorizar o pagamento

Iniciar pagamento:

  1. Faça uma solicitação POST para um endpoint da API do terminais, especificando um corpoPaymentRequest que contenha:

    • SaleData.SaleToAcquirerData: authorisationType=PreAuth indica que esta é uma solicitação de pré-autorização.

    Para mais detalhes sobre solicitação e resposta, consulte Pré-autorização.

  2. Quando você receber a resposta de pré-autorização:

    • Armazene o arquivo pspReference da AdditionalResponse para uso posterior ao ajustar a autorização ou ao capturar o pagamento.
    • o Se você estiver usando o ajuste de autorização síncrona, também use o URL para decodificar o blob adjustAuthorisationData e o armazene.

  3. Verifique se o cliente adicionou uma gorjeta.

  4. Se o cliente adicionou uma gorjeta, calcule a porcentagem da gorjeta usando os seguintes valores da AdditionalResponse: posadditionalamounts.originalAmountValue e posAmountGratuityValue. TEstes são o valor original e o valor da gorjeta minor units.

Etapa 2 (opcional): Ajuste a pré-autorização

If the tip adds more than 20% to the original amount, increase the authorized amount:

  1. Faça uma solicitação POST para o endpoint do /payments/{paymentPspReference}/amountUpdates, especificando:

    • paymentPspReference: O pspReference da solicitação de pré-autorização.
    • amount: A currency e value da nova quantia em minor units. Esta é a soma do valor pré-autorizado e do valor adicional.
    • reason: DelayedCharge
    • merchantAccount: O nome da sua merchant account usada para processar o pagamento.

    Para mais detalhes sobre solicitação e resposta, consulte Pré-autorização.

  2. Verifique se recebeu a notificação assíncrona. Isso informa se o novo valor foi autorizado.

Etapa 3: Capturar o pagamento

Para garantir que o valor original mais o valor da gorjeta sejam liquidados em sua conta, você precisa capturar o pagamento manualmente:

  1. Faça uma solicitação POST para o endpoint do  /payments/{paymentPspReference}/captures , especificando:

    • paymentPspReference: A pspReference da pré-autorização original.
    • amount: A currency e o value valor final em in minor units. Esta é a soma do valor pré-autorizado e da gorjeta.
    • merchantAccount: O nome da sua merchant account usada para processar o pagamento.

    Para mais detalhes sobre solicitação e resposta, consulte Pre-autorização.

  2. Certifique-se de receber a notificação assíncrona. Isso informa se o valor final foi capturado.

Condições para gorjeta com pré-autorização

Em alguns países (EUA, Cingapura e Hong Kong), uma prática comum é que o cliente assine o valor da gorjeta no recibo depois de apresentar seu cartão e concluir o pagamento original. Se você deseja seguir esta prática, leve em consideração que:

  • A gorjeta com pré-autorização é permitida nos seguintes setores:

    MCC Descrição
    4121 Táxis e limusines
    5812 Restaurantes
    5813 Bares, Tabernas, Casas Noturnas, Salões de Coquetéis e Discotecas
    5814 Restaurantes fast food
    7230 Salões de beleza e Barbearias
    7298 Spas de saúde e beleza
  • As bandeiras exigem um ajuste de autorização se a gorjeta for superior a 20% da quantidade autorizada original. Se o emissor recusar esta autorização adicional, você poderá receber um estorno pela parte do valor final que estiver acima do valor original mais 20%.

  • Você precisará capturar manualmente o pagamento.

  • O fluxo é suportado apenas nos cartões de crédito American Express, Discover, Mastercard e Visa. Não é suportado para carteiras digitais e cartões de débito.

Veja também