## Visão geral

Uma **oferta** é um preço reutilizável que você cadastra uma vez e reaproveita em várias vendas.
Existem três tipos:

- **Order bump**: aparece no **checkout** como uma oferta-relâmpago e, quando aceita, entra como uma
  **linha extra** na cobrança que está sendo criada.
- **Upsell**: oferta **pós-compra de um clique**, normalmente um item de maior valor, que gera uma
  **nova cobrança** para o contato.
- **Downsell**: também pós-compra de um clique, usada como alternativa mais barata quando o cliente
  recusa o upsell — igualmente gera uma **nova cobrança**.

Em todos os casos a oferta guarda nome, valor, moeda e método; você só a vincula a uma venda ou
contato no momento certo.

## Pré-requisitos

- Um **gateway conectado** e válido (veja *Conectar gateway*).
- Opcional: um **produto do Catálogo** vinculado à oferta (`catalog_product_id`), para reaproveitar o
  cadastro do produto.
- Defina na oferta a **conexão** (gateway) e o **método** (`billing_type`) que serão usados quando ela
  virar cobrança — especialmente para upsell e downsell.
- Para **aceitar** uma oferta (upsell/downsell), o contato precisa de dados mínimos (nome e,
  idealmente, e-mail/telefone) para o pagador no gateway.

## Como funciona

- **Order bump no checkout**: a oferta é convertida em uma **linha de cobrança** (nome, valor e moeda
  são "fotografados" no momento). Ela soma ao total **somando uma nova linha** — nunca altera o valor
  de uma cobrança já existente. A linha guarda apenas a referência da oferta nos metadados.
- **Upsell / downsell pós-compra**: ao aceitar a oferta para um contato, a plataforma **cria uma nova
  cobrança** reaproveitando a **conexão**, o **valor** e os **dados do pagador** já conhecidos — sem
  redigitar nada. Essa cobrança segue o fluxo normal (gateway → webhook → cartão de pagamento na
  conversa), exatamente como qualquer outra cobrança.
- A oferta **nunca é alterada** quando é aceita: ela é um modelo; cada aceite gera uma cobrança nova e
  independente.
- O aceite pós-compra só funciona para uma oferta **ativa e não arquivada**. Um order bump pertence
  ao checkout e é recusado nessa ação. Repetir a mesma tentativa de rede recupera a mesma cobrança.

## Configurações & opções

Campos de uma oferta:

| Campo | Para que serve |
|---|---|
| **Nome** | Identifica a oferta e vira a descrição da cobrança/linha. Obrigatório. |
| **Tipo** (`kind`) | `order_bump`, `upsell` ou `downsell`. |
| **Valor** | Preço da oferta (unidades maiores, ex.: `49.90`). Precisa ser maior que zero. |
| **Moeda** | Código de 3 letras (ex.: `BRL`). |
| **Método** (`billing_type`) | PIX, boleto ou cartão usado quando a oferta virar cobrança. |
| **Conexão** | O gateway (conexão de pagamento) usado para cobrar. |
| **Produto do catálogo** | Vínculo opcional a um produto do Catálogo. |
| **Descrição** | Texto auxiliar da oferta. |
| **Ativa / inativa** | Ofertas inativas não são oferecidas. |

## Passo a passo

1. Na área de Pagamentos, abra **Ofertas** e crie uma nova oferta.
2. Informe **nome**, escolha o **tipo** (order bump, upsell ou downsell), o **valor** e a **moeda**.
3. Defina o **método** e a **conexão** (gateway) que serão usados ao gerar a cobrança.
4. (Opcional) Vincule um **produto do catálogo** e escreva uma **descrição**.
5. Salve. A oferta fica disponível enquanto estiver **ativa**.
6. Para **aplicar um order bump**, use a oferta no **checkout**: aceita pelo cliente, ela vira uma
   linha extra na cobrança.
7. Para **aceitar um upsell/downsell**, dispare o aceite da oferta para o **contato** (opcionalmente
   ligado a uma conversa): a plataforma gera uma **nova cobrança** e a envia na conversa.
8. Para desativar uma oferta, **arquive-a** — ela some das ofertas disponíveis, mas o preço é
   preservado (nunca apagamos um preço que um funil ativo possa referenciar).

## Casos de uso

- **Aumentar o ticket** com um order bump no checkout ("adicione a garantia estendida por R$ 19,90").
- **Oferecer um upsell** logo após a compra ("leve a versão Pro com 1 clique").
- **Recuperar a venda com um downsell** quando o cliente recusa o upsell mais caro.
- Reutilizar a **mesma oferta** em várias conversas e checkouts, sem recadastrar o preço.

## Dicas, limites e boas práticas

- O **order bump não altera** uma cobrança já criada — ele apenas **adiciona uma linha** ao total no
  momento do checkout.
- Aceitar **upsell/downsell sempre cria uma cobrança nova** e independente; a oferta original
  permanece intacta.
- Ofertas são **arquivadas, não apagadas** — assim nenhum funil ou histórico que dependa daquele preço
  quebra.
- Defina **conexão e método** na oferta de upsell/downsell: sem eles, o aceite não consegue gerar a
  cobrança corretamente.
- Valores são em unidades maiores (R$ 49,90 = `49.90`); o total do checkout é a soma das linhas —
  nunca divida por 100.

## Solução de problemas

- **A oferta não aparece**: confira se ela está **ativa** e **não arquivada** (ofertas inativas ou
  arquivadas não são oferecidas).
- **O aceite falhou**: verifique se o **contato** tem os dados mínimos e se a **conexão** (gateway) da
  oferta é válida — o aceite cria uma cobrança real e precisa desses dados.
- **O valor saiu errado no order bump**: lembre que ele **soma uma linha** ao total; ele não substitui
  nem reduz o valor das demais linhas.
- **Não consigo excluir uma oferta**: ofertas são arquivadas (reversível) e não removidas — use o
  arquivar.

## Veja também

- [Criar cobrança e enviar na conversa](/hc/ajuda/articles/payments-criar-cobranca-enviar-na-conversa-pt-br)
- [Conectar gateway: Asaas e Mercado Pago](/hc/ajuda/articles/payments-conectar-gateway-pt-br)
- [Catálogo nativo de produtos e serviços](/hc/ajuda/articles/catalog-commerce-catalogo-nativo-pt-br)