> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cakto.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar Order Bumps do Produto

> Consulte as ofertas adicionais exibidas no checkout de um produto. Use este endpoint para listar, auditar e planejar as ofertas complementares que aumentam o valor médio do pedido.

#### Escopo

```bash theme={null}
    read products
```

## O que é um Order Bump?

Order bump é uma oferta complementar exibida no checkout, logo antes do pagamento. O cliente adiciona o produto extra com um único clique, sem sair da página de compra.

É uma das formas mais simples de aumentar o ticket médio sem criar novos funis de vendas.

<CardGroup cols={2}>
  <Card title="Aumente o ticket médio" icon="arrow-trend-up">
    Venda produtos complementares no momento em que o cliente já está decidido a comprar.
  </Card>

  <Card title="Baixo atrito" icon="hand-pointer">
    O cliente adiciona com um clique. Sem redirecionamentos, sem novos checkouts.
  </Card>

  <Card title="Custo zero de aquisição" icon="piggy-bank">
    Você não gasta mais em tráfego. A venda acontece para quem já está comprando.
  </Card>

  <Card title="Testes rápidos" icon="flask">
    Troque ofertas, ajuste preços e copy para descobrir o que converte mais.
  </Card>
</CardGroup>

***

## Quando usar cada endpoint

| Endpoint                                     | Ação          | Quando usar                                                            |
| -------------------------------------------- | ------------- | ---------------------------------------------------------------------- |
| `GET /products/{id}/bumps/`                  | **Listar**    | Para ver todas as ofertas adicionais de um produto e auditar posições. |
| `POST /products/{id}/bumps/`                 | **Criar**     | Para adicionar uma nova oferta complementar ao checkout.               |
| `POST /products/{id}/bumps/position_update/` | **Reordenar** | Para mudar a ordem de exibição dos order bumps no checkout.            |
| `GET /bumps/{id}/`                           | **Consultar** | Para obter os detalhes completos de um order bump específico.          |
| `PUT /bumps/{id}/`                           | **Atualizar** | Para alterar oferta, preço, copy ou imagem de um bump existente.       |
| `DELETE /bumps/{id}/`                        | **Remover**   | Para desativar uma oferta que não está convertendo.                    |

***

## Casos de uso

<AccordionGroup>
  <Accordion title="Vender produtos complementares" icon="cart-plus">
    Vende um curso de fotografia? Ofereça um kit de presets como order bump. O cliente compra o principal e adiciona o complemento em segundos.
  </Accordion>

  <Accordion title="Criar upgrades instantâneos" icon="star">
    Ofereça a versão premium, com aulas extras ou suporte prioritário, diretamente no checkout. Quem já vai comprar o básico pode querer o upgrade imediato.
  </Accordion>

  <Accordion title="Aumentar a recorrência" icon="rotate">
    Para assinaturas, use o order bump para oferecer um segundo acesso ou um plano anual com desconto no momento da adesão.
  </Accordion>

  <Accordion title="Testar ofertas sem risco" icon="chart-line">
    Crie dois ou três order bumps com produtos diferentes e acompanhe qual gera mais vendas adicionais. Ajuste conforme os resultados.
  </Accordion>
</AccordionGroup>

***

## Boas práticas

<Tip>
  **Ofereça o complemento certo.** O order bump deve ter relação direta com o produto principal. Ofertas genéricas convertem menos.
</Tip>

<Tip>
  **Preço acessível.** Order bumps com valor entre 30% e 50% do produto principal costumam converter melhor.
</Tip>

<Tip>
  **Copy clara.** Use títulos e descrições curtas que explicam o benefício em uma linha. Exemplo: *"Leve também o workbook por R\$ 19,90"*.
</Tip>

<Info>
  Order bumps são exibidos na ordem definida pelo campo `position`. Use o endpoint de **atualizar posições** para controlar qual oferta aparece primeiro no checkout.
</Info>


## OpenAPI

````yaml GET /public_api/products/{id}/bumps/
openapi: 3.0.3
info:
  title: Cakto API
  version: 1.0.0
  description: Documentação da API pública do Cakto.
servers:
  - url: https://api.cakto.com.br
    description: Cakto API
security: []
paths:
  /public_api/products/{id}/bumps/:
    get:
      tags:
        - order-bumps
      description: |-
        Public API for managing order bumps, inherits from OrderBumpAPI,
        customizes authentication and permission settings.
      operationId: order_bumps_list
      parameters:
        - in: path
          name: id
          schema:
            type: string
          required: true
        - name: limit
          required: false
          in: query
          description: Número de resultados a serem retornados por página.
          schema:
            type: integer
        - name: ordering
          required: false
          in: query
          description: Which field to use when ordering the results.
          schema:
            type: string
        - name: page
          required: false
          in: query
          description: Número da página a ser retornada.
          schema:
            type: integer
        - name: search
          required: false
          in: query
          description: A search term.
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedOrderBumpCreateList'
          description: ''
        '401':
          description: Request não autenticado devido à ausência ou invalidez do token.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthenticatedError'
              examples:
                Token ausente ou inválido:
                  $ref: '#/components/examples/UnauthenticatedErrorExample'
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OrderBumpGet404'
              examples:
                ProdutoNãoEncontrado:
                  value:
                    detail: Não encontrado.
          description: Corpo da resposta status 404
      security:
        - OAuth Token: []
components:
  schemas:
    PaginatedOrderBumpCreateList:
      type: object
      properties:
        count:
          type: integer
          example: 123
        next:
          type: string
          nullable: true
          format: uri
          example: http://api.example.org/accounts/?page=4
        previous:
          type: string
          nullable: true
          format: uri
          example: http://api.example.org/accounts/?page=2
        results:
          type: array
          items:
            $ref: '#/components/schemas/OrderBumpCreate'
    UnauthenticatedError:
      type: object
      properties:
        detail:
          type: string
    OrderBumpGet404:
      type: object
      properties:
        detail:
          type: string
      required:
        - detail
    OrderBumpCreate:
      type: object
      properties:
        id:
          type: string
          title: Identificador
          description: Identificador único do order bump no sistema
          maxLength: 40
        product:
          type: string
          description: Produto que será oferecido como order bump
          title: Produto
        referencePrice:
          type: number
          format: double
          nullable: true
        offer:
          type: string
          title: Oferta
          description: Oferta que será oferecida como order bump
          nullable: true
        cta:
          type: string
          nullable: true
          title: Call to Action
          description: Texto do botão de call to action do order bump
          maxLength: 255
        title:
          type: string
          nullable: true
          title: Título
          description: Título do order bump
          maxLength: 255
        description:
          type: string
          nullable: true
          title: Descrição
          description: Descrição do order bump
        position:
          type: integer
          maximum: 2147483647
          minimum: -2147483648
          title: Posição
          description: Posição na qual o order bump será exibido no checkout
        showImage:
          type: boolean
          title: Exibir imagem
          description: Indica se a imagem do order bump será exibida no checkout
      required:
        - product
  examples:
    UnauthenticatedErrorExample:
      summary: Token ausente ou inválido
      description: Token ausente ou inválido
      value:
        detail: As credenciais de autenticação não foram fornecidas.
  securitySchemes:
    OAuth Token:
      type: http
      scheme: bearer
      in: header
      name: Authorization
      description: >-
        Token de autenticação do tipo `Bearer {access_token}`, onde
        `{access_token}` é o token obtido no fluxo de
        [autenticação](/authentication).

````