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" 
}'