Pular para o conteúdo
Central de Ajuda

Como gerar uma assinatura parcelada via API

Gere uma assinatura parcelada via API

Na iugu, você cria uma cobrança recorrente pelo Painel ou pela API. Aqui está o passo a passo via API, com a cobrança parcelada no cartão do seu cliente.

O que faz a fatura ser parcelada

Na chamada de cobrança direta (charge), envie:

customer_payment_method_id
invoice_id
months = parcelas

Prefere fazer pelo Painel? Veja como criar uma recorrência parcelada no Painel iugu.

Ver o passo a passo no Painel

Passo a passo via API

Siga os passos abaixo, na ordem.

1

Confirme se o parcelamento está ativo na sua conta

Configurações › Cartão de Crédito › Parcelas

Tela Cartão de crédito nas configurações do painel iugu, com a opção Parcelas marcada e destacada e o campo Número máximo de parcelas

2

Gere o token do cartão

Use a chamada de token (payment_token) ou o iugu.js.

Criar TokenTokenização com iugu.js

3

Gere o cliente

Criar Cliente

4

Gere o método de pagamento do cliente

Não defina como método padrão. Envie:

token

o token do passo 2

description

“Cartão do cliente”

set_as_default

false

Criar Forma de Pagamento

5

Gere uma assinatura

Criar Assinatura

6

A assinatura vai criar uma fatura

O retorno da chamada traz a fatura em recent_invoices.

7

Aplique a fatura na chamada de cobrança direta

Use a chamada charge (cobrança direta).

Cobrança Direta

8

Na charge, envie os parâmetros de parcelamento

customer_payment_method_id

ID da forma de pagamento do cliente (passo 4)

invoice_id

ID da fatura gerada pela assinatura (passo 6)

months

quantidade de parcelas

💡 Dica: use os gatilhos

Utilize os gatilhos para ser notificado da criação de faturas da assinatura.

Ver Gatilhos na documentação

Como funciona a renovação

Ao final do período contratado, a assinatura é renovada automaticamente, mantendo os critérios definidos na contratação original. Se as condições de parcelamento na renovação forem iguais às da assinatura inicial, a cobrança é feita no cartão com a mesma quantidade de parcelas escolhida pelo cliente na contratação.

⚠️ Atenção: o parcelamento consome o limite total do cartão

Em pagamentos recorrentes parcelados, o limite do cartão do comprador é consumido pelo valor total do pagamento e liberado novamente ao longo dos meses.

Exemplo: em uma fatura de R$ 300 parcelada em 3x, o comprador consome R$ 300 do limite do cartão de crédito, que é liberado conforme o pagamento das parcelas.

Se ele parcelar mais de um ciclo, o limite consumido será a soma do valor total dos ciclos menos o valor das parcelas já pagas ao banco.

Esse artigo foi útil?
Usuários que acharam isso útil: 3 de 15
Ainda precisa de ajuda? Nosso time responde pela sua conta iugu.
Abrir solicitação

0 Comentários

Artigo fechado para comentários.