Reativar uma Assinatura Bloqueada

Este end-point tem como objetivo reativar uma assinatura bloqueada por falhas em pagamento. Os motivos da falha em pagamento e bloqueio podem ser visualizados na sessão de cobranças.

Os campos deste formulários não são obrigatórios, pois é permitido que a realivação seja realizado com o mesmo cartão presente na assinatura, mas é dado a possibilidade de enviar dados de um novo cartão.

📘

Cobrança teste

Quando uma é solicitado a reativação de uma assinatura, é necessário realizar uma nova conbrança teste no valor de R$ 1,00 para autenticar os dados do cartão e verificar a disponibilidade de limites.

Resposta da requisição

Variável	Tipo	Descrição
id	Number	Identificador da assinatura
status	SubscriptionStatus	Status atual da assinatura
customer	SubscriptionCustomer	Dados do cliente da assinatura
creationDate	Date	Data de criação da assinatura
firstCharge	Date	Data da primeira cobrança a ser realizada
plan	PlanResponse	Plano da recorrência
chargeDay	Number	Dia da cobrança das cobranças recorrentes - nulo em caso de Plano semanal (period = WEEKLY)
charges	ChargeResponse[ ]	Lista das cobranças recorrentes
cancellationDate	Date	Data-hora do cancelamento da assinatura

SubscriptionStatus

Variável	Descrição
GENERATED	A assinatura gerada, mas ainda não foi confirmada. Aguardando processo de validação do cartão de crédito
ACTIVE	A assinatura está ativa e as cobranças serão realizadas normalmente
PAYED	A assinatura paga completamente
TO_CANCEL	A assinatura cancelada, mas ainda não foi possível cancelar todas as cobranças
CANCELED	A assinatura e suas cobranças foram canceladas
BLOCKED	A assinatura bloqueada por falha no pagamento

SubscriptionCustomer

Variável	Tipo	Descrição
name	String	Nome do assinante da recorrência
phone	String	Número do telefone do assinante da recorrência
email	String	Endereço de e-mail do assinante da recorrência
legalDocument	String	Documento legal do assinante da recorrência
birthDate	Date	Data de aniversário do assinante da recorrência

PlanResponse

Variável	Tipo	Descrição
id	Number	Identificador único do plano
status	PlanStatus	Status do plano
name	String	Nome do plano
description		Descrição do plano
periodicValue	Number	Valor base a ser cobrado nas parcelas do plano em centavos
duration	Number	Tempo de duração do plano, sendo nulo = infinito
period	PlanPeriod	Periodicidade do plano

PlanStatus

Variável	Tipo	Descrição
ACTIVE	String	O plano está ativo e pode ser usado normalmente
INACTIVE	String	O plano está inativo e não pode aparecer para o cliente como opção
BLOCKED	String	O plano está bloqueado para uso

PlanPeriod

Variável	Tipo	Descrição
WEEKLY	String	Cobranças realizadas semanalmente
MONTHLY	String	Cobranças realizadas mensalmente
QUARTERLY	String	Cobranças realizadas trimestralmente
SEMIANNUAL	String	Cobranças realizadas semestralmente
YEARLY	String	Cobranças realizadas anualmente

ChargeResponse

Variável	Tipo	Descrição
id	Number	Id da cobrança que foi buscada
order	String	Número de ordem da cobrança
description	String	Descrição da cobrança
softDescriptor	String	Descrição dos dados de fatura do cartão de crédito do cliente
date	Date	Data da cobrança
totalValue	Number	Valor total da cobrança recorrente
subscriptionId	Number	Identificador da assinatura da qual a cobrança pertence
status	ChargeStatus	Status atual da cobrança
installment	Number	Número da parcela a qual a determinada cobrança se refere
paymentInformation	Transaction[]	Informações de tentativas de pagamento da cobrança
reference	String	Número de referencia da cobrança de recorrência
cancellationDate	Date	Data de cancelamento da cobrança (caso ela tenha sido cancelada)

ChargeStatus

Variável	Descrição
PAYED	Cobrança paga
TO_CANCEL	Cobrançaem processo de cancelada dado o cancelamento de uma assinatura
CANCELED	Cobrança cancelada dado o cancelamento de uma assinatura
FAILED	Todas as tentativas de cobrança falharam
RETRY	A tentativa de cobrança falhou e deve ser realizada novamente
PENDING	A cobrança está pendente e deverá ser realizada na sua data
BLOCKED	A cobrança está bloqueada tendo em devido a falta de pagamento

Transaction

Variável	Tipo	Descrição
order	String	Número de ordem da transação realizada
status	TransactionStatus	Status da transação
acquirerMessage	String	Mensagem de erro em caso de falha de pagamento
valueCents	Number	Valor da cobrança

TransactionStatus

Variável	Descrição
AUTHORIZED	Transação autorizada e efetivada
NOT_AUTHORIZED	Transação não autorizada
CANCELED	Transação cancelada
ERROR	Aconteceu um erro na realização da transação