Order bump por item: o que muda nas suas automações e webhooks

Quando alguém compra o seu produto junto com um order bump, cada produto da compra aparece separado — na sua lista de vendas, na área de membros do aluno e nas suas automações. Antes, a compra era tratada como um bloco único.

Na prática, isso muda três coisas para você:

• Você pode estornar apenas um produto da compra (só o order bump, ou só o produto principal), sem precisar estornar tudo.

• As automações passam a conseguir identificar qual produto foi comprado ou estornado.

• Os valores enviados em cada disparo passam a ser os daquele produto, e não os da compra inteira.

Suas automações continuam disparando como sempre — nada do que já funciona precisa ser refeito. Mas se você usa o valor recebido no webhook para emitir nota, lançar em planilha ou conciliar, leia com atenção a seção Os valores agora são por produto.

Se você ainda não usa o recurso, veja primeiro O que é e como configurar o Order Bump?

Na compra: continua igual, com informações a mais

Quando o pagamento é confirmado, continuam disparando os mesmos dois gatilhos de sempre:

As informações novas: os dois gatilhos passam a enviar a variável {{item_id}}, que identifica aquele produto dentro da compra, e os valores de cada disparo passam a ser os do produto.

Os valores agora são por produto

Todo disparo descreve um produto. Os campos financeiros são a fatia daquele produto na cobrança:

Atenção: se a sua automação usava {{payment_value}} esperando o valor total da compra, troque para {{purchase_total_value}}. As variáveis de total estão disponíveis nos gatilhos do produto principal; o disparo de order bump descreve só aquele item e não recebe o total.

Em compras sem order bump nada muda: {{purchase_total_value}} é igual a {{payment_value}}.

Order bump em oferta de assinatura

Order bump agora também pode ser oferecido em ofertas de assinatura. O que chega nas automações depende da forma de pagamento:

Cartão — cada order bump é uma cobrança própria, então você recebe:

• Pagamento confirmado da assinatura, com o valor do ciclo;

• Pagamento confirmado via order bump para cada adicional cobrado, com o valor do adicional (cobrança própria: os valores são exatos, sem rateio);

• nada é disparado para um adicional que foi recusado ou não cobrado.

Pix ou boleto — a primeira fatura é única (mensalidade + adicionais). Os disparos seguem a lógica de rateio descrita acima, e {{purchase_total_value}} traz o total da fatura.

Renovações: cobram apenas a assinatura. Nenhum evento de order bump é disparado nos ciclos seguintes.

No estorno: um gatilho para cada situação

É o gatilho Estorno order bump que avisa quando um produto específico da compra foi estornado. Se você já tinha uma automação com esse gatilho, ela passa a disparar nesses cenários.

Por que o status do pagamento continua "pago" no estorno de um item

Ao estornar apenas o order bump de uma compra unitária, a compra continua ativa — o produto principal segue válido e o aluno mantém o acesso a ele. Por isso a variável {{payment_status}} continua como pago: ela fala do pagamento como um todo, não do item.

Para saber que houve um estorno, use as variáveis do item:

Como acompanhar um produto do início ao fim

Use o {{item_id}}. Ele é o mesmo na confirmação e no estorno, então o seu sistema consegue amarrar o ciclo completo:

1. Pagamento confirmado via order bump → chega item_id: 123 com o produto e o valor dele.

2. Estorno order bump → chega item_id: 123, com item_status: refunded e o valor devolvido.

É a forma mais segura de casar os eventos — melhor do que comparar por nome de produto.

O que você precisa fazer nas suas automações

Automações que você já tem: continuam funcionando normalmente. Elas só não trazem as informações novas, porque o conteúdo enviado é o que você configurou quando criou a automação.

Se quiser receber as informações novas, edite a automação:

1. Abra a automação em Automações.

2. No campo de conteúdo do webhook, clique em Variáveis.

3. Insira as variáveis que quiser (por exemplo {{item_id}}, {{item_status}}, {{item_refunded_value}}, {{purchase_total_value}}).

4. Salve.

Automações novas: já nascem com todas as variáveis disponíveis no gatilho escolhido.

Para ser avisado do estorno de um order bump, crie uma automação com o gatilho Estorno order bump — ou use o modelo pronto com esse nome.

A lista completa de variáveis dos gatilhos de pagamento está em Variáveis Disponíveis - Gatilhos de Pagamento e Engajamento.

Exemplo do que chega no estorno de um order bump

{
  "payment_id": 67596,
  "payment_status": "paid",
  "product_name": "Mentoria em grupo",
  "payment_value": 1042,
  "item_id": 55941,
  "item_status": "refunded",
  "item_refunded_at": "2026-08-17T13:12:21-03:00",
  "item_refunded_value": 1042
}

Lendo o exemplo: a compra continua ativa (payment_status: paid), mas o order bump "Mentoria em grupo" foi estornado, devolvendo R$ 10,42 ao comprador.

Os valores vêm em centavos. Quando a compra é parcelada com juros, o valor de cada produto inclui a parte proporcional dos juros que o comprador pagou — por isso ele pode ser um pouco maior que o preço anunciado.

Agentes de integração

Os agentes prontos (as integrações de um clique) continuam funcionando na compra e no estorno da compra inteira. O que muda:

Agentes de nota fiscal (Spedy, SmartNotas, Notazz): a emissão passa a sair uma nota por produto — uma para o principal e uma para cada order bump —, e a soma das notas fecha com o total cobrado. Integrações criadas de agora em diante já vêm com esse comportamento.

Se você já tinha uma integração de nota fiscal ativa, refaça a configuração do agente (ou acione o suporte) para que ele passe a emitir a nota de cada order bump. Sem isso, em compras com order bump a nota sai apenas com o valor do produto principal.

• No SmartNotas e no Notazz, estornar um order bump cancela a nota daquele produto.

• No Spedy, o cancelamento automático não é possível — se precisar cancelar a nota de um produto estornado, faça isso direto no Spedy.

Agentes de remover acesso: agentes criados de agora em diante já reagem também ao estorno de um produto só — e removem na ferramenta externa o acesso apenas daquele produto. Se você já tem um agente de remover acesso ativo, ele é acionado somente no estorno da compra inteira; para ele passar a reagir ao estorno de um order bump, refaça a configuração do agente.

Dentro da HeroSpark o acesso é sempre revogado apenas do produto estornado, independentemente do agente — o restante da compra continua liberado.

Agentes de acompanhamento de vendas (métricas e rastreamento) continuam recebendo apenas o estorno da compra inteira, para não contar o mesmo estorno duas vezes.

Notas fiscais emitidas pela HeroSpark

A emissão nativa continua sendo uma nota por cobrança:

• Estorno da compra inteira: a nota é cancelada automaticamente, como sempre foi.

• Estorno de apenas um produto em compra unitária: a nota não é cancelada, porque a compra continua ativa e o restante do valor segue válido. Se precisar ajustar, faça no seu emissor.

• Estorno da cobrança de um order bump em assinatura: a nota daquele order bump é cancelada automaticamente; a nota da assinatura não é afetada.

Resumo rápido