Data de criação: 21/08/2025
Sumário
O que é cashback? 3
Configuração cashback 3
Cashback a receber 4
Duração e dias para liberação 7
Dias a mais de validade para uma movimentação 8
Porcentagem de utilização no pedido 9
Ativo no site 11
Cashback no site 12
Página do produto 12
Página de carrinho 12
Página de finalização 13
Retorno 14
Cadastro de cupom 15
Prioridade de cupom 15
Movimentação cashback para o cliente 16
Origens movimentação cashback 17
Pedido realizado 17
Pedido cancelado 17
Devolução 18
Utilização cashback 18
Porcentagem máxima igual a 100% 19
Porcentagem menor que 100% 20
Bloqueio de cashback 22
Relatórios 23
Movimentações cashback 23
Clientes com cashback 24
O que é cashback?
Palavra em inglês que significa “dinheiro de volta”, o cashback é o método onde o consumidor recebe parte do valor de volta ao comprar algum produto e esse valor fica disponível para uma nova compra após o pagamento integral e a conclusão do pedido (entrega).
Configuração cashback
O sistema de Cashback pode ser ativado e desativado em momentos / campanhas específicas.
Enquanto ele estiver ativado, as compras realizadas irão gerar créditos a serem usados de acordo com os prazos definidos no sistema.
Após a desativação, as futuras compras param de gerar créditos, porém os créditos previamente gerados, continuam com sua validade, de acordo com o definido junto ao sistema.
O primeiro passo para ter o cashback no site é acessar a configuração de cashback, na página da administração que pode ser acessada através do painel no canto superior direito, como mostrado abaixo.

Acessando essa opção poderão ser definidas as seguintes configurações:

Cashback a receber
Para calcular o cashback a receber, dois campos da configuração serão considerados: porcentagem e créditos geram cashback.
A fórmula utilizada sofrerá alterações de acordo com o que foi definido no campo “créditos geram cashback”.
Com essa opção marcada, os créditos e cashbacks utilizados no pedido não são descontados para o cálculo:
CASHBACK = ( Valor dos produtos - Desconto cupom - Desconto à vista ) * ( Porcentagem / 100)
Pedido com desconto à vista:
Porcentagem = 10%
Valor dos Produtos = R$ 100,00
Desconto à vista (10%) = R$ 10,00
( 100.00 - 10.00 ) * ( 0.10 ) => R$ 9,00 de cashback.
Pedido com desconto de cupom:
Porcentagem = 10%
Valor dos Produtos = R$ 100,00
Desconto Cupom (5%) = R$ 5,00
( 100.00 - 5.00 ) * ( 0.10 ) => R$ 9,50 de cashback.
Pedido com crédito utilizado:
Porcentagem = 10%
Valor dos Produtos = R$ 100,00
Crédito utilizado = R$ 60,00
( 100.00 ) * ( 0.10 ) => R$ 10,00 de cashback.
Pedido com cashback utilizado:
Porcentagem = 10%
Valor dos Produtos = R$ 100,00
Cashback utilizado = R$ 70,00
( 100.00 ) * ( 0.10 ) => R$ 10,00 de cashback.
Pedido com crédito e cashback utilizado:
Porcentagem = 10%
Valor dos Produtos = R$ 100,00
Crédito utilizado = R$ 60,00
Cashback utilizado = R$ 40,00
( 100.00 ) * ( 0.10 ) => R$ 10,00 de cashback.
Pedido com desconto à vista, cupom, crédito e cashback utilizado:
Porcentagem = 10%
Valor dos Produtos = R$ 100,00
Desconto Cupom (5%) = R$ 5,00 | Crédito utilizado = R$ 10,00
Cashback utilizado = R$ 15,00 | Desconto à vista (10%) = R$ 7,00
( 100.00 - 5.00 - 7.00 ) * ( 0.10 ) => R$ 8,80 de cashback.
Com a opção desmarcada, os créditos e cashbacks são descontados:
CASHBACK = ( Valor dos produtos - Desconto cupom - Desconto à vista - Créditos - Cashbacks ) * ( Porcentagem / 100)
Pedido com desconto à vista:
Porcentagem = 10%
Valor dos Produtos = R$ 100,00
Desconto à vista (10%) = R$ 10,00
( 100.00 - 10.00 ) * ( 0.10 ) => R$ 9,00 de cashback.
Pedido com desconto de cupom:
Porcentagem = 10%
Valor dos Produtos = R$ 100,00
Desconto Cupom (5%) = R$ 5,00
( 100.00 - 5.00 ) * ( 0.10 ) => R$ 9,50 de cashback.
Pedido com crédito utilizado:
Porcentagem = 10%
Valor dos Produtos = R$ 100,00
Crédito utilizado = R$ 60,00
( 100.00 - 60.00 ) * ( 0.10 ) => R$ 4,00 de cashback.
Pedido com cashback utilizado:
Porcentagem = 10%
Valor dos Produtos = R$ 100,00
Cashback utilizado = R$ 70,00
( 100.00 - 70.00 ) * ( 0.10 ) => R$ 3,00 de cashback.
Pedido com crédito e cashback utilizado:
Porcentagem = 10%
Valor dos Produtos = R$ 100,00
Crédito utilizado = R$ 60,00
Cashback utilizado = R$ 40,00
( 100.00 - 60.00 - 40.00 ) * ( 0.10 ) => R$ 0,00 de cashback.
O pedido não ganha cashback nesse cenário.
Pedido com desconto à vista, cupom, crédito e cashback utilizado:
Porcentagem = 10%
Valor dos Produtos = R$ 100,00
Desconto Cupom (5%) = R$ 5,00 | Crédito utilizado = R$ 10,00
Cashback utilizado = R$ 15,00 | Desconto à vista (10%) = R$ 7,00
( 100.00 - 5.00 - 7.00 - 15.00 - 10.00 ) * ( 0.10 ) => R$ 6,30 de cashback.
Caso o cliente realize uma devolução parcial do pedido gerado, o valor da sua movimentação será calculado proporcionalmente à parte do pedido que não foi devolvida. Devoluções completas acarretam o cancelamento da movimentação cashback. Para ilustrar o cálculo de atualização do valor é apresentado o exemplo abaixo sendo considerado o pedido de exemplo citado anteriormente.
Valor Cashback Inicial = R$ 8,10
Valor dos Produtos = R$ 100,00
Valor Devolvido = R$ 60,00
O valor devolvido representa 60% do valor dos produtos, assim o novo
valor da movimentação será 40% do valor inicial.
Novo Valor Cashback = 40% de R$ 8.10 => R$ 3,24
Atenção: A atualização do valor ou cancelamento da movimentação do cashback será realizada ao conferir a devolução.
Duração e dias para liberação
Os campos duração de dias do cashback e dias para o cashback liberado, são relacionados à efetivação do cashback. Quando um cliente realiza um pedido com direito a cashback é gerada uma movimentação que fica com status pendente e, permanece assim até que o pedido seja concluído e tenha passado os dias configurados para liberação (dias para o cashback liberado), feito isso a movimentação fica com o status efetivado.
Atenção: A contagem dos dias para liberação do cashback começa a partir da data de conclusão do pedido.
O campo duração de dias do cashback é referente à validade, ou seja, a quantidade de dias que o cliente vai poder utilizar o benefício de uma movimentação liberada. Caso o cliente não utilize o cashback e essa validade fique ultrapassada, a movimentação ficará com status expirado e não será mais possível utilizar o benefício. Elaboramos o exemplo a seguir para demonstrar o funcionamento.
Data da Compra = 30/11/2022
Data de Envio do Pedido = 03/12/2022
Data de Conclusão do Pedido (entrega) = 10/12/2022
Prazo Definido no Sistema para liberação = 15 dias
Liberado para Uso = 25/12/2022
Prazo Definido no Sistema para Uso = 30 dias
Validade Cashback: 25/01/2023
Dias a mais de validade para uma movimentação
O campo de dias a mais de validade para o cashback tem como objetivo aumentar a validade do crédito nas seguintes situações:
Estorno de cashback utilizado em um pedido, em que a movimentação originária tenha validade inválida.
Pedido 1525
Valor Produtos = R$ 299,90
Valor Cashback Utilizado = R$ 50,00
O cashback usado é proveniente da seguinte movimentação:
Valor: R$ 50,00 | Validade: 03/04/2023 | Origem Pedido Realizado
Ao realizar o cancelamento do pedido 1525 no dia 04/04/2023, será estornado ao cliente o valor de R$ 50,00. A validade desse saldo será o dia atual mais os dias definidos na configuração cashback. Nesse exemplo consideramos que está setado o valor padrão, ou seja, 1 dia a mais. Dessa forma, o cliente terá até o dia 05/04/2023 para utilizar o cashback estornado.
Desbloqueio de cashback ao finalizar um processo de devolução, nos casos em que a validade do saldo bloqueado tenha sido expirada.
Pedido 1545
Valor cashback a receber = R$ 10,00
Data efetivação cashback = 22/04/2024
Validade cashback = 22/05/2024
O cliente solicitou a devolução fora do prazo, devido a um dos produtos estar com defeito. Assim, ao habilitar o formulário de devolução para o cliente, o saldo de cashback foi bloqueado até a finalização do processo de devolução.
Data habilitação formulário devolução = 20/05/2024
Data conclusão devolução = 25/05/2024
Quando a devolução foi concluída, a validade do cashback já tinha expirado, assim, para o cliente não perder o benefício, a validade desse saldo será atualizada para o dia atual mais os dias definidos na configuração. Nesse exemplo consideramos que está setado o valor padrão, ou seja, 1 dia a mais. Dessa forma, o cliente terá até o dia 26/05/2023 para utilizar o cashback do pedido 1545.
Em ambos os casos, a nova validade será o dia atual mais a quantidade de dias definido na configuração.
Por padrão, a validade aumenta em 1 dia nessas situações.
Porcentagem de utilização no pedido
A porcentagem de utilização visa permitir que o cliente pague somente parte do pedido com cashback. Com isso, limitando o uso de cashback, a loja garante que o cliente realizará e pagará a maior parte do próximo pedido.
Por padrão, a porcentagem máxima de utilização é 100%, ou seja, o cliente consegue pagar um pedido completamente com o saldo de cashback.
Para se calcular o valor máximo que se pode utilizar de cashback num pedido, é necessário fazer o seguinte cálculo:
MÁXIMO CASHBACK = ( Valor dos produtos - Desconto cupom - Desconto à vista - Crédito + Frete ) * ( Porcentagem Máxima / 100)
Pedido com desconto à vista:
Porcentagem Máxima = 20%
Saldo cashback do cliente = R$ 150,00
Valor dos Produtos = R$ 100,00 | Frete: R$ 15,00
Desconto à vista = R$ 10,00
( 100.00 - 10.00 + 15.00 ) * ( 0.20 ) => 105.00 * 0.20 => R$ 21,00 de cashback.
Mesmo possuindo um saldo de R$ 150,00, o cliente poderá utilizar nesse pedido somente R$ 21,00.
O valor restante de cashback (R$ 129,00) poderá ser utilizado normalmente em outro pedido.
Pedido com desconto de cupom:
Porcentagem Máxima = 20%
Saldo cashback do cliente = R$ 10,00
Valor dos Produtos = R$ 200,00 | Frete: R$ 15,00
Desconto Cupom (5%) = R$ 5,00
( 200.00 - 5.00 + 15.00 ) * ( 0.20 ) => 210.00 * 0.20 => R$ 42,00 de cashback.
Como o valor máximo de cashback é maior que o saldo, o cliente poderá utilizar todo o cashback no pedido, no caso R$ 10,00.
Pedido com crédito utilizado:
Porcentagem Máxima = 50%
Saldo cashback do cliente = R$ 150,00
Valor dos Produtos = R$ 100,00
Crédito utilizado = R$ 10,00 | Frete: R$ 0,00
( 100.00 - 10.00 ) * ( 0.50 ) =>90,00 * 0.50 => R$ 45,00 de cashback.
Mesmo possuindo um saldo de R$ 150,00, o cliente poderá utilizar nesse pedido somente R$ 45,00.
O valor restante de cashback (R$ 104,80) poderá ser utilizado normalmente em outro pedido.
Pedido com desconto à vista, cupom e crédito utilizado:
Porcentagem Máxima = 20%
Saldo cashback do cliente = R$ 150,00
Valor dos Produtos = R$ 100,00 | Frete: R$ 15,00
Desconto Cupom = R$ 10,00 | Desconto à vista = R$ 9,00
Crédito utilizado = R$ 0,00
( 100.00 - 10.00 - 9.00 + 15.00 ) * ( 0.20 ) => 19.20 => R$ 19,20 de cashback.
Mesmo possuindo um saldo de R$ 150,00, o cliente poderá utilizar nesse pedido somente R$ 19,20.
O valor restante de cashback (R$ 130,80) poderá ser utilizado normalmente em outro pedido.
Ativo no site
Por fim, os campos ativo para cupons e ativo no site controlam a disponibilidade do cashback no site.
Com o ativo no site marcado, todos os clientes terão direito a ganhar o cashback ao realizar o pedido.
Com o ativo para cupons, apenas clientes que tenham acesso a algum cupom de cashback, se beneficiarão do valor de volta. Essa configuração visa permitir campanhas de cashback apenas para determinados clientes (Clientes Vips).
Mesmo com essas opções desmarcadas, se existir movimentações com status pendente o sistema continuará com o processo normal de liberação, expiração e utilização desse benefício.
Cashback no site
Com o cashback ativo no site, seja ele para todo site, ou apenas para pedidos que tenham algum cupom de cashback, o benefício será apresentado para o cliente nas seguintes páginas:
Página do produto
O valor exibido é referente ao cashback do produto:
Valor do produto * ( Porcentagem/100) )

Página de carrinho
O valor exibido é referente à soma de todos os produtos do carrinho menos o desconto de cupom.
( Valor dos produtos - Desconto Cupom ) * ( Porcentagem/100) )
Página de finalização
O valor de cashback exibido é referente ao valor total de todos os produtos no carrinho do cliente menos os devidos descontos (cupom, à vista, crédito, cashback) .
( Valor dos produtos - Desconto cupom - Desconto à vista - Crédito
utilizado - Cashback utilizado ) * ( Porcentagem / 100) 
Retorno
É informado ao cliente sobre a liberação do cashback e de como ele será informado.

Cupom de cashback
Outra forma de permitir que o cliente ganhe cashback ao realizar um pedido, é com o cupom de cashback. Criando um cupom assim, é possível fazer promoções específicas e privilegiar os clientes mais importantes para o site.
O funcionamento é bem simples: somente com o cupom no carrinho, o cliente ganha cashback.
Atenção: O funcionamento do cupom de cashback, depende do cupom estar cadastrado com o campo cashback marcado e a opção ativo para cupons na configuração também estar ativo.
Cadastro de cupom
Na página de cupom, a opção cashback se encontra na aba descontos.O cupom poderá acumular os benefícios de frete grátis, cashback, desconto e valor.


Atenção: Não é possível utilizar cupom combo com cashback.
Prioridade de cupom
Com uma nova possibilidade de vantagem no cupom, o cashback também foi adicionado no minha loja como opção de prioridade de cupom automático.

O algoritmo de prioridade funciona da seguinte forma:
Prioridade: Desconto.
Cupom A: automático com desconto de R$ 50,00.
Cupom B: automático com Frete Grátis.
Nessa situação o cupom que será adicionado ao carrinho será o cupom A.
Prioridade: Desconto.
Cupom A: automático com desconto de R$ 50,00.
Cupom B: automático com desconto de R$ 80,00.
Nessa situação o cupom que será adicionado ao carrinho será o cupom B.
Prioridade: Frete Grátis.
Cupom A: automático com desconto de R$ 50,00.
Cupom B: automático com Frete Grátis.
Nessa situação o cupom que será adicionado ao carrinho será o cupom B.
Prioridade: Cashback.
Cupom A: automático com cashback.
Cupom B: automático com Frete Grátis.
Nessa situação o cupom que será adicionado ao carrinho será o cupom A.
Movimentação cashback para o cliente
O cliente poderá consultar suas movimentações de cashback acessando o
painel no site. Ali será informado o saldo atual de cashback e
informações sobre as movimentações, como valor, status e validade,
conforme apresentado nas imagens abaixo.

Origens movimentação cashback
Pedido realizado
Forma tradicional de cashback, com parte do valor pago no pedido realizado retornando para o cliente com uma movimentação cashback de status pendente.
Pedido cancelado
Caso um pedido utilizador de cashback seja cancelado, esse valor utilizado será estornado por N movimentações, de acordo com o número de movimentações que foram utilizadas naquele pedido. Cada movimentação de estorno terá a mesma validade da movimentação original, e se por acaso a validade já tenha expirado, será o dia atual mais a quantidade de dias definida na configuração cashback.
Atenção: A única exceção de estorno de cashback ocorre em casos em que a movimentação original tem origem “Pedido Cancelado” e validade já fora do prazo, em que não será retornado esse valor dessa movimentação.
Elaboramos o exemplo a seguir para demonstrar o funcionamento:
Pedido 1527
Valor Produtos = R$ 150,50
Valor Cashback Utilizado = R$ 100,00
Dias a mais na validade = 1
O cashback usado está dividido em duas movimentações:
Movimentação 1 = R$ 40,00 | Validade = 03/04/2023 | Origem Pedido Cancelado
Movimentação 2 = R$ 60,00 | Validade = 03/04/2023 | Origem Pedido Realizado
Ao realizar o cancelamento do pedido 1527 no dia 04/04/2023, será estornado ao cliente o valor de R$60,00 em uma movimentação válida até o dia 05/04/2023, data atual mais quantidade de dias a mais na validade.
O valor utilizado da Movimentação 2 não será devolvido, visto que é de origem “Pedido Cancelado” e cai na exceção citada acima.
Devolução
Caso um pedido utilizador de cashback seja devolvido de forma completa, esse valor utilizado será estornado por N movimentações, de acordo com o número de movimentações que foram utilizadas naquele pedido ao conferir a devolução. Cada movimentação de estorno terá a mesma validade da movimentação original, e se por acaso a validade já tenha expirado, será o dia atual mais a quantidade de dias definida na configuração cashback. O cashback estornado via devolução segue o mesmo padrão citado acima no exemplo.
Em pedidos devolvidos pagos completamente com cashback sendo devolvidos, de forma completa ou não, será estornada uma movimentação de estorno como valor devolvido sendo a validade a menor data das movimentações originais.
Utilização cashback
O saldo de cashback disponível aparecerá para o cliente no checkout de finalização, que por sua vez terá a opção para utilizar no cashback no pedido.

O valor de utilização do cashback dependerá da porcentagem máxima definida na configuração cashback.
Porcentagem máxima igual a 100%
Caso a porcentagem máxima seja 100, isso quer dizer que o cliente tem a possibilidade de pagar completamente o pedido:

Se o cliente tiver um saldo correspondente a todo o valor dos produtos, porém apenas uma parte do frete, o benefício será aplicado apenas ao valor dos produtos.


Atenção: É possível utilizar saldo de créditos e cashback juntos para realizar um pedido, porém os créditos têm prioridade maior, ou seja, será utilizado todo o crédito para depois começar a ser descontado do cashback. Um pedido com valor inteiro pago por créditos e cashback, ficará com a forma de pagamento Créditos.


Porcentagem menor que 100%
Com a porcentagem máxima definida com um valor menor que 100, ao marcar o checkbox de utilização de cashback, o sistema vai calcular o valor máximo que pode ser utilizado. Caso o saldo do cliente seja maior, um alerta será emitido. No exemplo a seguir, o cashback pode representar somente 50% do valor do pedido.




Atenção: Ao marcar o checkbox de utilização, o desconto à vista não é considerado no valor máximo de cashback que pode ser utilizado. Caso o cliente opte por finalizar com uma forma de pagamento com desconto, o valor de cashback usado será atualizado.


Bloqueio de cashback
O bloqueio de um valor de cashback funciona nos casos em que ocorrem devoluções e cancelamentos de pedidos fora do prazo padrão estipulado pela loja que tiveram seu cashback efetivado.
Ao realizar um pedido que gerou cashback, e ter esse valor efetivado em sua conta, o cliente poderá solicitar à loja o cancelamento, ou devolução por inúmeros motivos. Entretanto, o cashback proveniente do pedido a ser cancelado pode já ter sido utilizado, e devolver ou cancelar o pedido pode ser prejuízo para loja. Dessa forma, caso o cliente tenha utilizado algum valor do cashback do pedido, não será possível fazer devoluções do pedido, sendo exibida a seguinte mensagem na view-pedido.

Na situação em que o valor do cashback gerado pelo pedido não foi utilizado, será possível realizar a devolução do pedido, no caso, habilitar o formulário de devolução, ou devolver de forma direta.
No caso da habilitação do formulário de devolução, ao habilitar, o valor de cashback gerado por esse pedido a ser devolvido será bloqueado. Com o prosseguimento do processo de devolução o valor de cashback do pedido será atualizado( ao conferir ) e se o novo valor for diferente de 0, será desbloqueado ao ser concluída a devolução.
Ao realizar a devolução direta, o valor do cashback é recalculado e o
valor do saldo alterado instantaneamente com a devolução.
⚠ Quando a devolução for conferida e o cashback desbloqueado, o cliente terá um novo prazo para utilização do cashback. Esse prazo será o dia da
conclusão da devolução mais a quantidade de dias definida na
configuração de cashback.
Relatórios
Em relação aos relatórios de administração, possuem duas páginas mostrando os dados de cashback:

Movimentações cashback
O relatório mostra todas as movimentações de cashbacks com a possibilidade de filtrar pela data de cadastro, data de efetivação, data de utilização, validade, cliente, pedido e status da movimentação.

Além dos filtros, há também as informações por página e totais: valor efetivado, valor expirado, valor utilizado e valor à receber.

As utilizações de cada movimentação também são mostradas na parte de pedidos utilizadores.

Clientes com cashback
O relatório mostra todos os clientes com saldo de cashback ativo, trazendo informações como id, nome, email e um link para visualização de todas as movimentações daquele cliente. Também é possível buscar por um cliente por id, e-mail e nome.

