---
title: "Create Discount"
method: POST
path: "/app/discount"
tags: ["Discounts"]
---

# Create Discount

`POST /app/discount`

Cria um cupom de desconto.

## Request body

- object
  - `coupon` string, required — O cupom que será criado. Aceita apenas letras, números, hífens e underlines.
  - `applies_to` number[], required — Lista de ID dos produtos em que o cupom poderá ser aplicado. Use `[-1]` para aplicar a todos os produtos.
  - `type` 'PRICE' | 'PERCENTAGE', required — O tipo do desconto, podendo ser `PRICE` ou `PERCENTAGE`
  - `value` number, required — O valor do desconto. Para `PERCENTAGE`, o valor é em porcentagem (ex: 50 = 50%). Para `PRICE`, o valor é em centavos da moeda.
  - `max_uses` number — A quantidade máxima de usos que o desconto pode ter
  - `expires_in` string, date — A data de expiração do desconto
  - `min_price` number — Valor mínimo do pedido para que o cupom possa ser aplicado. Intervalo: 0 a 999999.
  - `limit_criteria` 'CLIENT_IDENTIFIER' | 'CLIENT_EMAIL' | 'CLIENT_DISCORD' — Critério de limitação de uso por cliente. Quando definido, cada cliente só poderá usar o cupom uma vez com base no critério escolhido. Valores possíveis: `CLIENT_IDENTIFIER`, `CLIENT_EMAIL`, `CLIENT_DISCORD`
  - `restricted_to_criteria` 'CLIENT_IDENTIFIER' | 'CLIENT_EMAIL' | 'CLIENT_DISCORD' — Tipo de restrição para limitar o cupom a clientes específicos. Deve ser usado junto com `restricted_to`. Valores possíveis: `CLIENT_IDENTIFIER`, `CLIENT_EMAIL`, `CLIENT_DISCORD`
  - `restricted_to` string[] — Lista de identificadores dos clientes que poderão usar o cupom. Requer que `restricted_to_criteria` esteja definido. Ex: lista de e-mails, IDs Discord ou identificadores.

## Response `200`

Cupom de desconto criado.

- Discount
  - `id` number
  - `store_id` number
  - `coupon` string
  - `type` 'PRICE' | 'PERCENTAGE'
  - `value` number
  - `applies_to` number[]
  - `uses` number
  - `max_uses` number, nullable
  - `expires_in` string, nullable
  - `min_price` number, nullable
  - `limit_criteria` 'CLIENT_IDENTIFIER' | 'CLIENT_EMAIL' | 'CLIENT_DISCORD', nullable
  - `restricted_to_criteria` 'CLIENT_IDENTIFIER' | 'CLIENT_EMAIL' | 'CLIENT_DISCORD', nullable
  - `restricted_to` string[], nullable
  - `created_at` string
  - `updated_at` string

---

[API](https://skmtc.net/centralcart/apis/centralcart-api.md) · [All operations](https://skmtc.net/centralcart/apis/centralcart-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/centralcart/centralcart-api/revisions/6cbd98848375/schema)