Criar uma regra
1
Nome
Um nome interno que diga o que a regra faz, ex.: “Brinde no 2º pedido”.
2
Disparador
Quando a regra é disparada:
- Número de pedido específico — o ciclo N da assinatura (ex.: a 3ª cobrança). Com Aplicar por cliente ativado, a contagem soma os pedidos de todas as assinaturas do cliente e a recompensa é concedida uma única vez por cliente; desativado, a contagem é por assinatura e a recompensa é concedida uma vez por assinatura.
- Sequência de pedidos — N ciclos seguidos sem interrupção. A sequência é quebrada se passar mais de 1,5× a frequência do plano sem um pedido: uma pausa longa ou uma cobrança que não foi recuperada a reiniciam; uma pausa breve retomada em tempo a mantém.
3
Recompensa
Pelo menos uma das duas (podem ser combinadas):
- Desconto — percentual ou valor fixo sobre os produtos daquela única cobrança (o frete não recebe desconto; o imposto é recalculado). Aplica-se a partir do pedido 2 em diante: para dar desconto no primeiro pedido existe o desconto de primeira compra do plano.
- Brindes — um ou mais produtos/variantes do catálogo que são adicionados a custo R$ 0 ao pedido daquele ciclo.
4
Condição (opcional)
Status da assinatura que devem ser atendidos no momento de aplicar: Ativa, ou Cobrança falhada (o ciclo vinha de uma recusa e foi recuperado). É atendida por qualquer um dos marcados; sem marcar nenhum, aplica-se sempre.As condições são avaliadas no momento da cobrança, então não existe a opção “Pausada”: uma assinatura pausada tem o débito pausado no Mercado Pago e não gera cobranças.
Se um cliente atende aos critérios de várias regras no mesmo ciclo, todas as recompensas são aplicadas naquele pedido.
Como são aplicadas
- Brindes: são somados como linhas a R$ 0 ao pedido da Shopify do ciclo que disparou a regra. O estoque do brinde segue a mesma lógica de inventário configurada para aquele produto — com uma exceção deliberada: um brinde sem estoque nunca retém o pedido pago; ele é omitido (fica registrado nos logs) e o pedido sai de todo modo. Se o brinde foi omitido, a recompensa não é contada como aplicada nem é comunicada ao cliente, e a regra pode premiá-lo em um ciclo posterior.
- Descontos: como o Mercado Pago cobra o valor recorrente antecipadamente, o desconto é preparado um ciclo antes (o valor do débito é reduzido para aquela cobrança e restaurado automaticamente depois). O pedido da Shopify daquele ciclo é emitido com os preços com desconto, então o pedido e a cobrança coincidem. Se o valor com desconto ficasse abaixo do mínimo do Mercado Pago, a regra é omitida e isso fica registrado.
- Cada recompensa entregue fica contada na regra (“Aplicada N vezes”) e emite o evento “Surpresa aplicada” para o Klaviyo / Shopify Flow — você pode montar um e-mail de aviso, ou não comunicar nada e fazer com que seja uma surpresa de verdade. O aviso do brinde sai quando o pedido que o leva foi criado, e não antes.
Se você mudar o preço de uma assinatura (troca de produto, quantidade ou atualização em massa de preços) enquanto ela tinha um desconto preparado, o desconto é cancelado: o seu preço novo prevalece. A regra pode voltar a prepará-lo em um ciclo posterior.