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 duas 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.
Suas automações atuais continuam disparando como sempre — nada do que já funciona precisa ser refeito. O que muda é que existem informações novas disponíveis, e um cenário novo (o estorno de um produto só) que você pode automatizar.
Se você ainda não usa o recurso, veja primeiro O que é e como configurar o Order Bump?
Na compra: continua igual, com uma informação a mais
Quando o pagamento é confirmado, continuam disparando os mesmos dois gatilhos de sempre:
| Gatilho | Quando dispara |
|---|---|
| Pagamento confirmado | uma vez, para o produto principal da compra |
| Pagamento confirmado via order bump | uma vez para cada order bump comprado junto |
A informação nova: os dois gatilhos passam a enviar a variável {{item_id}}, que identifica aquele produto dentro da compra.
No estorno: um gatilho para cada situação
| Situação | Gatilho que dispara |
|---|---|
| Você estorna a compra inteira | Estorno feito pelo produtor (como sempre foi) |
| Você estorna apenas o order bump | Estorno order bump |
| Você estorna o último produto que faltava, fechando a compra | Estorno order bump (do item) e, ao concluir, Estorno feito pelo produtor |
É o gatilho Estorno order bump que avisa quando um produto específico da compra foi estornado. Se você já tinha uma automação configurada com esse gatilho, ela passa a disparar nesse cenário.
Por que o status do pagamento continua "pago" no estorno de um item
Ao estornar apenas o order bump, 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:
| Variável | O que traz |
|---|---|
{{item_id}} |
identificador do produto dentro da compra (o mesmo da confirmação) |
{{item_status}} |
situação do item — refunded quando estornado |
{{item_refunded_at}} |
data e hora do estorno daquele item |
{{item_refunded_value}} |
valor devolvido ao comprador, em centavos |
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:
-
Pagamento confirmado via order bump → chega
item_id: 123com o produto e o valor dele. -
Estorno order bump → chega
item_id: 123, comitem_status: refundede 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, sem nenhuma ação sua. 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:
-
Abra a automação em Automações.
-
No campo de conteúdo do webhook, clique em Variáveis.
-
Insira as variáveis que quiser (por exemplo
{{item_id}},{{item_status}},{{item_refunded_value}}). -
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",
"offer_price": 199,
"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 devolvido 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, como envio para plataformas externas) continuam funcionando normalmente na compra e no estorno da compra inteira.
O estorno de um produto só é um cenário novo: se você usa um agente para remover acesso em uma ferramenta externa, ele é acionado quando a compra inteira é estornada. Para reagir ao estorno de apenas um order bump, crie uma automação com o gatilho Estorno order bump.
Notas fiscais
A emissão continua exatamente como antes: uma nota por pagamento, com o valor total pago (incluindo os order bumps).
-
Estorno da compra inteira: a nota é cancelada automaticamente, como sempre foi.
-
Estorno de apenas um produto: a nota não é cancelada, porque a compra continua ativa e o restante do valor segue válido. Se precisar ajustar a nota nesse caso, faça o ajuste direto no seu emissor.
Resumo rápido
| Situação | O que acontece |
|---|---|
| Compra com order bump | Um gatilho de confirmação para cada produto, como sempre — agora com {{item_id}} |
| Estorno da compra inteira | Gatilho de estorno de sempre + nota fiscal cancelada |
| Estorno de um produto só | Gatilho Estorno order bump, com valor e data do item; a compra segue ativa e a nota não é cancelada |
| Automações antigas | Continuam funcionando; edite se quiser as variáveis novas |