Criar Assinatura

Body Params
string

Identificador do Plano. Só é enviado para assinaturas que não são credits_based

string
required

ID do Cliente

date

Data de Expiração "YYYY-MM-DD HH:MM:SS +TIMEZONE". (Data da primeira cobrança, as próximas datas de cobrança dependem do "intervalo" do plano vinculado).

splits
array of objects

Regras de divisão (Split Payment) para todas as Faturas geradas por esta Assinatura.

splits
boolean

Apenas Cria a Assinatura se a Cobrança for bem sucedida. Isso só funciona caso o cliente já tenha uma forma de pagamento padrão cadastrada. Não enviar "expires_at".

boolean

Desabilita o envio de emails notificando o vencimento de uma fatura em assinaturas que podem ser pagas com boleto bancário

payable_with
array of strings

Método de pagamento que será disponibilizado para as Faturas desta Assinatura (all, credit_card, bank_slip ou pix). Obs: Dependendo do valor, este atributo será herdado, pois a prioridade é herdar o valor atribuído ao Plano desta Assinatura; caso este esteja atribuído o valor ‘all’, o sistema considerará o payable_with da Assinatura; se não, o sistema considerará o payable_with do Plano

payable_with
boolean

É uma assinatura baseada em créditos? booleano

int32

Preço em centavos da recarga para assinaturas baseadas em crédito

int32

Quantidade de créditos adicionados a cada ciclo, só enviado para assinaturas credits_based

int32

Quantidade de créditos que ativa o ciclo, por ex: Efetuar cobrança cada vez que a assinatura tenha apenas 1 crédito sobrando. Esse 1 crédito é o credits_min

subitems
array of objects

Adiciona itens de cobrança a mais na assinatura do cliente. "price_cents" valor mínimo 100. Limite de 30 subitems

subitems
custom_variables
array of objects

Variáveis Personalizadas

custom_variables
boolean

Habilita/Desabilita transações em duas etapas para a assinatura (precisa ter o da conta ativado para usar)

boolean

Quando uma assinatura tem uma fatura expirada, se esse campo estiver como FALSE, assinatura não será suspensa. (porém é necessário ajustar a data de vencimento para seguir com o ciclo.

boolean

Somente efetua a cobrança do primeiro ciclo no dia do vencimento. Por padrão, ao criar uma assinatura e a data atual esteja menor que o billing_days da conta ou do plano, será cobrado.

string

Altera a descrição da cobrança no cartão de crédito do cliente final (Até 12 caracteres). Caso não seja enviado, será utilizada a descrição configurada na conta.

string

Cliente é redirecionado para essa URL após efetuar o pagamento da Fatura pela página de Fatura da Iugu.

Responses

Language
Credentials
Query
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json