# Gorjeta no Checkout: guia completo > Apresentação O módulo Gorjeta no Checkout (dftip) acrescenta à página de carrinho da sua loja um bloco «Acrescentar uma gorjeta» que permite ao cliente deixar uma gorjeta opcional: uma percentagem,… - Página: - Idioma: pt - Atualizado em: 2026-09-09 - Outros idiomas: [fr](https://www.datafirefly.com/documentation/dftip/index.md), [en](https://www.datafirefly.com/en/documentation/dftip/index.md), [es](https://www.datafirefly.com/es/documentation/dftip/index.md), [de](https://www.datafirefly.com/de/documentation/dftip/index.md), [it](https://www.datafirefly.com/it/documentation/dftip/index.md), [pl](https://www.datafirefly.com/pl/documentation/dftip/index.md), [nl](https://www.datafirefly.com/nl/documentation/dftip/index.md) - Índice: ## Apresentação O módulo **Gorjeta no Checkout** (`dftip`) acrescenta à página de carrinho da sua loja um bloco **«Acrescentar uma gorjeta»** que permite ao cliente deixar uma gorjeta opcional: uma **percentagem**, um **valor fixo** ou um **valor livre**. A gorjeta passa depois a integrar nativamente a encomenda, sem qualquer sobreposição do núcleo do PrestaShop. Ideal para artesãos, criadores e restauração. A gorjeta é suportada por uma linha de encomenda dedicada, cujo preço é fixado para o carrinho em curso através de um `specific_price` limitado a esse carrinho. Circula, por isso, corretamente no total pago, no IVA, na fatura e nas eventuais notas de crédito, exatamente o mecanismo que o PrestaShop usa para os preços personalizados em edição de encomenda. ## Compatibilidade - PrestaShop 8.0 a 9.x - PHP 7.4 a 8.3 - Loja única e multiloja - 5 idiomas: FR, EN, ES, DE, IT - Tema Classic e temas personalizados - Sem dependências (nem Composer nem frameworks) O pacote de traduções não inclui o português. Os textos do bloco (título e subtítulo) são campos multi-idioma que preenche você mesmo, mas as restantes cadeias do módulo aparecem no idioma de recurso enquanto não as traduzir em **Parâmetros avançados > Traduções > Traduções dos módulos**. ## Instalação 1. No back-office, abra **Módulos > Gestor de módulos**. 2. Clique em **Carregar um módulo** e selecione o ficheiro `dftip.zip`. 3. Depois de instalado, clique em **Configurar**. Na instalação, o módulo regista os seus hooks, cria um **produto virtual oculto «Gorjeta»** (fora do catálogo e fora da pesquisa, sem portes) destinado a suportar o valor da gorjeta, e aplica as suas definições predefinidas: gorjeta em percentagem de 5, 10 e 15 %, valor livre permitido e sem IVA. ## Configuração Todas as definições estão na página de configuração do módulo. - **Ativar o módulo**: mostra ou oculta o bloco de gorjeta. - **Título e subtítulo**: textos do bloco, personalizáveis e traduzíveis em cada idioma. - **Tipo de gorjeta**: _Percentagem_, _Valor fixo_ ou _Ambos_. - **Percentagens propostas**: lista separada por vírgulas, por exemplo `5,10,15`. - **Valores fixos propostos**: lista separada por vírgulas na moeda predefinida, por exemplo `1,2,5`. - **Base de cálculo da percentagem**: total de produtos **com IVA** ou **sem IVA**. - **Permitir um valor livre**: acrescenta um campo de introdução livre. - **Valor livre mínimo / máximo**: limites aplicados ao valor livre. - **Imposto aplicado à gorjeta**: **Sem imposto** por predefinição; pode selecionar um grupo de imposto se o seu caso o exigir. - **Mostrar o bloco na página do carrinho**: ativa a apresentação do seletor na página do carrinho. O título e o subtítulo são campos multi-idioma: selecione cada idioma no seletor do campo para adaptar o texto. São fornecidos valores predefinidos nos cinco idiomas logo na instalação, sem português. ## Funcionamento ### Como a gorjeta é acrescentada Quando o cliente escolhe uma gorjeta, o módulo memoriza a sua escolha (tipo e valor) para o carrinho em curso, acrescenta a linha «Gorjeta» ao carrinho e fixa o seu preço exato com um `specific_price` limitado a esse carrinho. A operação decorre em AJAX, sem recarregamento, e o total é atualizado de imediato. ### Percentagem recalculada automaticamente Numa gorjeta em percentagem, o valor acompanha o conteúdo do carrinho: se o cliente acrescentar ou retirar um produto, o módulo recalcula o valor e ressincroniza a linha antes do pagamento. A base de cálculo (total de produtos com ou sem IVA) é definida na configuração e exclui sempre a própria linha de gorjeta e os portes. ### Integração nativa na encomenda Como a gorjeta é uma verdadeira linha de carrinho, fica incluída no total efetivamente pago e é registada na encomenda no momento da validação. Aparece corretamente na fatura, na contabilidade e nas eventuais notas de crédito, sem qualquer override do núcleo. ### IVA da gorjeta Como uma gorjeta voluntária está em regra fora do âmbito do IVA, a linha é entregue **sem imposto** por predefinição. Se associar um grupo de imposto à gorjeta, o valor introduzido ou calculado é tratado como base sem imposto. Numa loja portuguesa, a gorjeta é faturada como uma linha da encomenda e entra no documento emitido pelo seu software de faturação certificado pela AT. Confirme com o seu contabilista certificado o tratamento a dar-lhe, nomeadamente a taxa de IVA a associar (ou a isenção a aplicar) e a conta a utilizar, antes de ativar o módulo em produção. O produto «Gorjeta» criado pelo módulo não deve ser eliminado nem tornado visível no catálogo: serve apenas para suportar o valor da gorjeta. Está oculto da pesquisa e das listagens e mantém-se sem portes. ### Retirar a gorjeta O cliente pode retirar a sua gorjeta a qualquer momento através da opção «Sem gorjeta». Se eliminar manualmente a linha «Gorjeta» a partir do carrinho, o módulo apaga também a escolha memorizada, para não a voltar a acrescentar. ## Perguntas frequentes e resolução de problemas ### O bloco de gorjeta não aparece na página do carrinho Confirme que o módulo está ativo e que a opção «Mostrar o bloco na página do carrinho» está assinalada. Limpe depois a cache do PrestaShop (Parâmetros avançados > Desempenho) e, durante os testes, desative a combinação e compressão (CCC). O bloco aparece quando o carrinho tem pelo menos um artigo. ### A gorjeta em percentagem não é atualizada quando altero o carrinho O recálculo ocorre na gravação do carrinho e no carregamento da página do carrinho ou do checkout. Se alterar o carrinho através de uma ação AJAX do tema, recarregue a página: o valor será ressincronizado antes do pagamento. ### A gorjeta aparece na fatura? Sim. A gorjeta é uma linha de encomenda de pleno direito: consta do detalhe da encomenda e da fatura, e é tida em conta nas notas de crédito. ### Posso aplicar IVA à gorjeta? Sim, selecionando um grupo de imposto na configuração. Por predefinição, a gorjeta é entregue sem imposto, em linha com a natureza de uma gorjeta voluntária. ### É compatível com o PrestaShop 9 e com multiloja? Sim. O módulo é compatível com PrestaShop 8 e 9, em loja única ou multiloja, e é multi-idioma, sem dependências Composer nem frameworks.