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 PainelPasso 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
2
Gere o token do cartão
Use a chamada de token (payment_token) ou o iugu.js.
3
Gere o 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
5
Gere uma 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).
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.
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. |
0 Comentários