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

# Get Discount

> Busca um cupom de desconto pelo código.
<Warning>Esta rota valida apenas que o cupom existe e está ativo. Valor mínimo, limite de usos, produtos elegíveis e expiração só são aplicados na criação do pedido, então trate a resposta como pré-visualização e não como garantia.</Warning>
<Note>Limitado a 20 requisições por minuto.</Note>



## OpenAPI

````yaml /openapi/storefront-checkout.yaml get /webstore/discount/{code}
openapi: 3.1.0
info:
  title: CentralCart Storefront API (Checkout)
  version: 1.0.0
  description: >-
    Carrinho, upsells, cupons, criação de pedido e acompanhamento do pagamento.
    Nenhum destes endpoints exige autenticação. A loja é resolvida pelo header
    `x-store-domain`.
servers:
  - url: https://api.centralcart.io/v1
    description: Produção
security: []
paths:
  /webstore/discount/{code}:
    get:
      tags:
        - Checkout
      summary: Get Discount
      description: >-
        Busca um cupom de desconto pelo código.

        <Warning>Esta rota valida apenas que o cupom existe e está ativo. Valor
        mínimo, limite de usos, produtos elegíveis e expiração só são aplicados
        na criação do pedido, então trate a resposta como pré-visualização e não
        como garantia.</Warning>

        <Note>Limitado a 20 requisições por minuto.</Note>
      operationId: getWebstoreDiscount
      parameters:
        - $ref: '#/components/parameters/StoreDomain'
        - name: code
          in: path
          required: true
          description: Cupom de desconto
          schema:
            type: string
      responses:
        '200':
          description: Cupom de desconto encontrado
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: number
                  store_id:
                    type: number
                  coupon:
                    type: string
                  type:
                    type: string
                    enum:
                      - PERCENTAGE
                      - FIXED
                  value:
                    type: number
                  applies_to:
                    type: array
                    description: IDs dos produtos elegíveis. Vazio significa todos.
                    items:
                      type: number
                  max_uses:
                    type: number
                    nullable: true
                  limit_criteria:
                    type: string
                  min_price:
                    type: number
                  expires_in:
                    type: string
                  created_at:
                    type: string
                  updated_at:
                    type: string
              example:
                id: 1
                store_id: 1
                coupon: PROMO10
                type: PERCENTAGE
                value: 10
                applies_to:
                  - 1
                  - 2
                  - 3
                max_uses: null
                limit_criteria: CLIENT_EMAIL
                min_price: 50
                expires_in: '2030-12-31T23:59:59.000-03:00'
                created_at: '2024-03-03T23:43:12.000-03:00'
                updated_at: '2024-03-03T23:43:12.000-03:00'
        '404':
          description: Cupom inexistente ou desativado
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                errors:
                  - message: Cupom de desconto não encontrado.
        '429':
          description: Limite de requisições atingido
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                errors:
                  - message: Resource rate limit reached.
                    code: RATE_LIMIT_REACHED
      security: []
components:
  parameters:
    StoreDomain:
      name: x-store-domain
      in: header
      required: true
      description: 'Domínio da sua loja (ex: sualoja.centralcart.ai)'
      schema:
        type: string
  schemas:
    Error:
      type: object
      properties:
        errors:
          type: array
          items:
            type: object
            properties:
              message:
                type: string
              code:
                type: string
              ref:
                type: string

````