Retorna uma desconto específico através do ID.

Um desconto pode ser aplicado à um item específico de uma assinatura (product_item) e possui duração configurável (cycles). Utilize este método para obter detalhes de um desconto específico.

Duração

A duração de um desconto pode ser definida através do atributo cycles que representa o número de ciclos de recorrência onde o desconto será aplicado. É possível, por exemplo, configurar um desconto apenas para a próxima fatura, ou então conceder um desconto permanente. Neste último caso, o atributo cycles deverá permanecer nulo.

Tipo

Cada desconto possui um tipo de cálculo diferente que deve ser informado no atributo discount_type. Os seguintes tipos de desconto estão disponíveis:

TipoDescrição
percentagePorcentagem: Desconto baseado na porcentagem informada. Utilize um valor númerico entre 0.01 e 100.
amountValor fixo: Desconto no valor exato informado. Mínimo: 0.01.
quantityQuantidade: Apenas para produtos com precificação por quantidade fixa (sem faixas). Informe um valor inteiro maior ou igual a 1.

Cálculo

Todos os descontos ativos serão aplicados no momento da geração da fatura e serão calculados a partir do valor original do item.

Caso o total de descontos seja superior ao valor original, o preço final do produto permanecerá R$ 0,00.

Desconto sobre desconto

Se um item possuir mais de um desconto ativo, todos eles serão calculados a partir do valor original, conforme mencionado acima. Como exemplo, considere um item que custava originalmente R$ 100,00 e recebeu dois descontos: R$ 10,00 e 50%:

Valor original: R$ 100,00
Desconto 1: R$ 10,00
Desconto 2: 50% de R$ 100,00 = R$ 50,00
--
Valor final do produto: R$ 100,00 - R$ 60,00 = R$ 40,00
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
int32
required

ID do desconto que deverá ser retornado.

Responses

Language
Credentials
Basic
base64
:
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json