Skip to main content
PATCH
Ativar ou arquivar cupom

Autorizações

Authorization
string
header
obrigatório

Chave secreta da conta: Authorization: Bearer sk_test_… ou sk_live_…. Use só no servidor.

Parâmetros de caminho

couponID
string<uuid>
obrigatório

Corpo

application/json
status
enum<string>
obrigatório

active para aceitar o cupom no checkout, archived para parar de aceitar.

Opções disponíveis:
active,
archived

Resposta

Sucesso.

Um desconto percentual que o comprador aplica no checkout com o code. Em assinaturas, duration define por quantos ciclos o desconto vale.

id
string<uuid>
obrigatório
code
string
obrigatório

O código que o comprador digita no checkout.

percentOff
string
obrigatório

Percentual de desconto, em texto decimal ("15" = 15%).

duration
enum<string>
obrigatório

once (só na primeira fatura), repeating (durante durationInCycles ciclos) ou forever (em todas as faturas).

Opções disponíveis:
once,
repeating,
forever
timesRedeemed
integer
obrigatório

Quantas vezes o cupom já foi usado.

status
enum<string>
obrigatório

active (aceito no checkout) ou archived (não aceito mais).

Opções disponíveis:
active,
archived
createdAt
string<date-time>
obrigatório
updatedAt
string<date-time>
obrigatório
durationInCycles
integer | null

Quantos ciclos o desconto vale. Só em cupons repeating.

maxRedemptions
integer | null

Quantas vezes o cupom pode ser usado no total. null = sem limite.

redeemBy
string<date-time> | null

Até quando o cupom pode ser aplicado. null = sem prazo.