Skip to main content
POST
Reativar assinatura
Reativa uma assinatura que o cliente cancelou (cancellation_reason: USER_ACTION). Se o cancelamento foi por falha de pagamento, a API não reativa. A resposta traz ACTIVE quando o ciclo ainda vale. Traz PENDING quando há cobrança. Para cartão e PIX imediato, a API enfileira a cobrança. A cobrança não acontece neste request. A resposta traz pix.qrcode como null. A resposta da reativação não traz o resultado dessa cobrança.

Fatura

No cancelamento, faturas open passam a void. Na reativação, o que acontece depende da fatura e do ciclo:
  • Se a fatura mais recente for void e due_at ainda estiver no futuro, ela volta a open.
  • Se due_at já passou ou for nulo, a API responde 422 (sem code público). A assinatura continua CANCELLED.
  • Se não houver fatura void e o ciclo já venceu, a API cria uma fatura open e a assinatura fica PENDING.
  • Se não houver fatura void e o ciclo ainda vale, a assinatura volta a ACTIVE. Ninguém é cobrado agora.

Pix Automático

Se a API retomar o Pix Automático existente, a resposta traz pix_type: "automatic" e pix.qrcode. Se não for possível retomar, a API responde 422 / UVV154673. A assinatura continua CANCELLED. Nesse caso, crie uma nova assinatura.
Erros comuns: 401/403 (credenciais ou produto Recorrência), 404 (não encontrada), 422 (status inválido, vencimento passado ou Pix Automático).

Authorizations

client-id
string
header
required
client-secret
string
header
required

Headers

client-id
string
required

ID público da credencial do merchant

client-secret
string
required

Secret da credencial do merchant

Path Parameters

subscriptionId
string<uuid>
required

Response

Assinatura reativada

subscription_id
string<uuid>

Identificador da assinatura reativada.

subscription_status
enum<string>

Status resultante: ACTIVE ou PENDING (se o ciclo estiver vencido).

Available options:
ACTIVE,
PENDING,
TRIAL,
PAST_DUE,
CANCELLED
invoice_id
string<uuid> | null

Invoice gerada quando a reativação exige nova cobrança. Nulo caso contrário.