Skip to main content
curl -X POST "https://api.chargefy.io/v1/discount-codes" \
  -H "Authorization: Bearer {{API_KEY}}" \
  -H "Content-Type: application/json" \
  -d '{
    "discount_id": "disc_123"
  }'
{
  "id": "dcode_123",
  "object": "discount_code",
  "code": "BLACK20",
  "created_at": "2026-05-21T12:00:00Z",
  "customer": "cus_123",
  "discount": "disc_123",
  "expires_at": null,
  "first_time_transaction": true,
  "is_active": true,
  "livemode": true,
  "max_redemptions": 500,
  "max_redemptions_per_customer": 1,
  "metadata": {},
  "minimum_amount": 10000,
  "minimum_amount_currency": "brl",
  "redemptions_count": 0,
  "updated_at": null,
  "valid": true
}
Cria um discount_code para um discount existente. Se code não for enviado, um código é gerado automaticamente.

Attributes

code
string
Código público. Aceita letras, números e hífens; é normalizado para maiúsculas.
discount_id
string
required
ID do desconto (disc_*).
customer
string
Cliente específico (cus_*) que pode resgatar este código. Quando omitido, qualquer cliente pode usar.
expires_at
string
Data ISO 8601 de expiração do código.
first_time_transaction
boolean
default:"false"
Quando true, restringe o resgate a clientes sem atividade de cobrança anterior.
max_redemptions
integer
Limite total de aplicações deste código.
max_redemptions_per_customer
integer
Limite de aplicações por cliente para este código.
metadata
object
Objeto livre para correlação.
minimum_amount
integer
Valor mínimo da compra em centavos.
minimum_amount_currency
string
Moeda do valor mínimo. Obrigatório quando minimum_amount é enviado.
curl -X POST "https://api.chargefy.io/v1/discount-codes" \
  -H "Authorization: Bearer {{API_KEY}}" \
  -H "Content-Type: application/json" \
  -d '{
    "discount_id": "disc_123"
  }'

Resposta

{
  "id": "dcode_123",
  "object": "discount_code",
  "code": "BLACK20",
  "created_at": "2026-05-21T12:00:00Z",
  "customer": "cus_123",
  "discount": "disc_123",
  "expires_at": null,
  "first_time_transaction": true,
  "is_active": true,
  "livemode": true,
  "max_redemptions": 500,
  "max_redemptions_per_customer": 1,
  "metadata": {},
  "minimum_amount": 10000,
  "minimum_amount_currency": "brl",
  "redemptions_count": 0,
  "updated_at": null,
  "valid": true
}