Suspender, Ativar e Remover Assinaturas
O que você irá aprender com esse artigo?
- Como suspender uma assinatura
- Como ativar uma assinatura
- Como remover uma Assinatura
Como suspender uma assinatura
Caso de Uso
“Cliente não deseja mais seguir com sua assinatura e solicita a suspensão.”
Diagrama de sequência
Para que o cliente não seja cobrado nos próximos ciclos de sua assinatura, é possível suspendê-la ao invés de remover a assinatura permanentemente.
Neste cenário, é possível reativar a assinatura futuramente caso o cliente solicite.
Para realizar a suspensão via API, é preciso realizar um POST na Endpoint de “Suspender Assinatura” https://api.iugu.com/v1/subscriptions/{id}/suspend, informando o parâmetro id da Assinatura.
Exemplo de request
curl --location --request POST 'https://api.iugu.com/v1/subscriptions/{{id_subscription}}/suspend' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic {{api_token in base64}}' \
--header 'Cookie: __cfruid=e245288b389fed8ddeab4d36894ae9d85d6ccc19-1634834882'
Exemplo de response
Como ativar uma assinatura
Caso de Uso
“Cliente deseja reativar sua assinatura e solicita a ativação.”
Diagrama de Sequência
Caso o cliente desejar reativar sua assinatura é possível somente quando ela está com status “suspensa”.
Para este cenário, é preciso realizar um POST na Endpoint de “Ativar Assinatura” https://api.iugu.com/v1/subscriptions/{id}/activate informando o parâmetro de id da assinatura.
Exemplo de Request
curl --request POST \
--url 'https://api.iugu.com/v1/subscriptions/{{id_subscriptions}}/activate' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic {{api_token in base64}}'
Exemplo de Response
Como remover assinatura
Caso de uso
"Cliente solicita a exclusão de sua assinatura por definitivo."
Diagrama de Sequência
Para este cenário, é preciso realizar um DELETE na Endpoint de “Remover Assinatura” https://api.iugu.com/v1/subscriptions/{id} informando o parâmetro de id da assinatura.
Exemplo de Request
curl --location --request DELETE 'https://api.iugu.com/v1/subscriptions/{{subscription_id}}' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic {{api_token in base64}}' \
--header 'Cookie: __cfruid=45d3c132585d9d277025a56502dc3fb5016073f9-1634913572' \
--data-raw ''
Exemplo de Response
Updated over 2 years ago