Códigos de desconto
Criar um código de desconto
Cria um código resgatável para um desconto.
Cria um
discount_code para um discount existente. Se code não for enviado,
um código é gerado automaticamente.
Só discount_id é obrigatório. Sem code, a Chargefy gera um código de
10 caracteres sozinha. Todo o resto tem default.
Attributes
Código público. Aceita letras, números e hífens; é normalizado para
maiúsculas. Precisa ser único na organização — código já existente retorna
409. Quando omitido, um código de 10 caracteres é gerado automaticamente.Cliente específico (
cus_*) que pode resgatar este código. Precisa existir
na organização — senão 404. Padrão: null (qualquer cliente pode usar).Data ISO 8601 de expiração do código. Não pode ser posterior ao
expires_at
do discount pai — senão 400. Padrão: null.Quando
true, restringe o resgate a clientes sem atividade de cobrança
anterior. Padrão: false.Limite total de aplicações deste código (inteiro positivo). Não pode exceder
o
max_redemptions do discount pai — senão 400. Padrão: null.Valor mínimo da compra na menor unidade da moeda (centavos em
brl) (inteiro positivo). Padrão: null.Moeda do valor mínimo. Obrigatório quando
minimum_amount é enviado; senão
400.Aceita hoje: brl. Maiúsculas valem como minúsculas (BRL é lido como brl); outra moeda retorna 400 com code: "unsupported_currency". Veja Moedas.O que a Chargefy resolve sozinha
- Sem
code, gera um código de 10 caracteres (letras maiúsculas e números, sem caracteres ambíguos). codeenviado é normalizado para maiúsculas.- Limites do código são validados contra o discount pai (
expires_atemax_redemptionsnão podem excedê-lo). first_time_transactionnascefalse,is_activenascetrueeredemptions_countnasce0.
Cenários de criação
(a) Código gerado automaticamente
Só o desconto pai. A Chargefy gera um código de 10 caracteres — use quando o código não precisa ser memorável (link direto, e-mail individual).(b) Código escolhido, com limites de campanha
code aceita letras, números e hífen, e é normalizado para maiúsculas na
comparação. Os limites são independentes: max_redemptions é o total do
código, max_redemptions_per_customer é por cliente, e minimum_amount
exige minimum_amount_currency.
cURL
(c) Código exclusivo de um cliente
customer restringe o resgate a um único cliente; first_time_transaction
limita a quem ainda não comprou.
cURL

