Diferença entre Cobrança Direta e Fatura
O que você ira aprender com esse artigo?
- O que é e por que usar cobrança direta.
- O que é e por que usar uma fatura.
O que é Cobrança Direta
Requisição utilizada para realizar uma cobrança simples de forma pontual utilizando os métodos de pagamento cartão de crédito e boleto.
Por que usar uma cobrança direta?
Com ela é possível realizar uma cobrança já inserindo os dados do cliente e o token gerado para o cartão de crédito (iugu js). Se o seu intuito é gerar apenas um boleto, essa chamada também retorna o PDF do boleto e o link de pagamento para efetuar o pagamento.
Modelo de link de pagamento:

A chamada de cobrança direta permite que seja definido o número de parcelas utilizado na cobrança em sua propriedade months.
Para essa chamada só é possível usar o split caso ele esteja configurado na conta, ou seja, quando gerado a cobrança e a conta mestre, ou subconta tiver um split configurado, automaticamente será realizado o split de pagamento pela plataforma iugu.
Para mais informações sobre split acesso o artigo Configura subconta por api.
Nessa chamada também é possível configurar um desconto para a cobrança que é exibido na fatura gerada na iugu.
Modelo de request:
curl --location --request POST 'https://api.iugu.com/v1/charge' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic {{api_token in base64}}' \
--header 'Cookie: __cfruid=4de6e8d698f34284d42117520658036e571b03dc-1634570591' \
--data-raw '{
"items": [
{
"description": "aaaa",
"quantity": 1,
"price_cents": 10000
}
],
"payer": {
"address": {
"street": "Conselheiro Lafayetti",
"number": "450",
"district": "São Paulo",
"city": "São Caetano do Sul",
"state": "SP",
"zip_code": "09550-000",
"complement": "AP 61"
},
"cpf_cnpj": "35914746817",
"name": "nome",
"phone": "11951701099"
},
"method":"bank_slip",
"order_id": "3123213",
"email": "[email protected]"
}'
Nessa chamada não é possível definir uma data de vencimento da cobrança, ela sempre ocorre de imediato.
O que é uma fatura?
A fatura é uma forma de cobrança da iugu que possibilitar efetuar cobranças com os métodos cartão de crédito, boleto e PIX, fora isso nela é possível definir como será realizado o split de pagamentos.
Por que usar a chamada de fatura?
No response dessa chamada é retornado uma url na propriedade secure_url, onde o cliente final pode acessar e efetuar o pagamento em um checkout da IUGU.
Modelo de checkout:

No response dessa chamada retornamos a linha digital do boleto e seu código de barras, já para o PIX disponibilizamos o QRcode e o copia e cola.
A fatura possibilita configurar o split de pagamento, onde é possível definir se ele vai ser único, múltiplo, por percentual, valor fixo, método de pagamento ou por parcela. Para mais informações criamos o artigo split por fatura.
Ao criar uma fatura é possível definir qual será sua data de vencimento, inserir e-mails para colocar em cópia do recebimento, definir uma url de retorno quando ocorrer um pagamento com cartão de crédito caso o cliente utilize o link de pagamento. Pode ser configurado multa e juros para uma cobrança, ou vincular a fatura em uma recorrência (assinatura) e configurar um desconto de adiantamento.
Modelo de request:
curl --location --request POST 'https://api.iugu.com/v1/invoices' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic {{api_token in base64}}' \
--header 'Cookie: __cfruid=4b912b504849ed04db06435b6ebbf9c01115cbe1-1634675233' \
--data-raw '{
"splits": [
{
"recipient_account_id": "B18135D7546845A397F4FB131A375B03",
"percent": 3
}
],
"customer_id":"6DA0201F156D4C9BA248DFE9D1A25A29",
"items": [
{
"description": "item de teste",
"quantity": 1,
"price_cents": 15000
}
],
"payable_with": [
"all"
],
"email": "[email protected]",
"due_date": "2021-10-19"
}'
Updated over 1 year ago