Passo 5: Recorrência

📘

O que você irá aprender com esse artigo?

  • Cliente
  • Plano
  • Assinatura

Cliente

Para cadastrar o Cliente, é obrigatório que os dados do nome, e-mail e endereço sejam preenchidos caso seja usado o método de pagamento boleto bancário. Além disso, para criação de uma Assinatura na iugu, é necessário que o Cliente seja criado antes da Assinatura. Caso seja utilizado o cartão como meio de pagamento, é obrigatório que o cartão seja salvo para realizar cobranças recorrentes. Veja mais detalhes sobre a criação do Cliente, a etapa de Tokenização e o armazenamento do cartão clicando aqui.

Plano

O Plano é o motor de uma venda recorrente. Nele é definido o intervalo entre cada cobrança, os valores, os métodos de pagamento aceitos, o número máximo de ciclos e o prazo para a geração da fatura. Ele permite como configuração os meios de pagamento: cartão de crédito, boleto bancário e/ou PIX. Veja a seguir alguns parâmetros essenciais para a criação do Plano. Para conhecer os demais campos localizados na requisição de Criar Plano, clique aqui.

  • “identifier”: É o id do Plano que deve ser informado na criação da Assinatura;
  • “interval”: Define o intervalo para a cobrança do Plano;
  • “interval_type”: Define o tipo de intervalo para a cobrança do Plano;
  • “value_cents”: Define o preço para a cobrança do Plano.

Assinatura

A Assinatura é a vinculação de um Plano a um Cliente. Nela é possível definir os meios de pagamento que serão usados (sendo esses métodos de pagamento iguais ao Plano ou mais específicos), uma data para o vencimento, o uso de créditos na Assinatura, etc. Veja a seguir alguns parâmetros essenciais para a criação da Assinatura. Para conhecer os demais campos presentes na requisição de Criar Assinatura, clique aqui.

  • “only_on_charge_success”: Permite a criação da Assinatura somente quando o pagamento retornar sucesso;
  • “payable_with”: Define o meio de pagamento que será usado para a cobrança da Assinatura;
  • “subitems”: Define os itens adicionais e/ou descontos que farão parte da cobrança da Assinatura, podendo ser recorrentes ou não.

Para mais informações sobre cobranças recorrentes, clique aqui.
Para informações sobre upgrade e downgrade de assinatura, clique aqui.
Para informações sobre como suspender, ativar e remover assinaturas, clique aqui.
Para informações sobre upgrade de assinatura sem cálculo de pro rata, clique aqui.