Agora é possível criar um QR Code Pix com prazo de expiração!

No endpoint Criar Fatura — POST /v1/invoices, foi adicionado o parâmetro pix_qr_code_expires_at.

{
  "pix_qr_code_expires_at": "2024-09-05T19:52:37"
}

Importante

Este parâmetro deve seguir o parâmetro ISO 8601.

Agora é possível desativar subcontas!

Utilize o endpoint Desativar Subconta — /v1/marketplace/deactivate. No body da requisição, informe o account_id da conta que deseja desativar.

Requisição exemplo

curl --request POST \
     --url 'https://api.iugu.com/v1/marketplace/deactivate?api_token=your_live_api_token' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "account_id": "911E249555C24F28A30602D647A1CCBB"
}
'

Response exemplo

{
  "success": true,
  "message": "A conta está em processo de desativação, em alguns instantes será finalizado."
}

Importante ⚠️

Atente-se as informações importantes antes de requisitar este endpoint:

1. Ao requisitar este endpoint, todas as faturas, assinaturas e carnês pendentes serão cancelados e a conta terá o status unverified.
2. A conta não poderá ter saldo.
3. A requisição precisa ser feita utilizando o live_api_token da Conta Mestre.

Novos parâmetros no endpoint de Criar Fatura - POST /v1/invoices.

pix_remittance_info string, - Máximo 140 caracteres,
pix_additional_info array of objects, - Máximo 5 itens. Cada item deste array, precisa conter "nome"e "valor".
name (string) - Limite de 50 caracteres.
value (string) - Limite de 200 caracteres.

Response exemplo:

pix_additional_info — array of objects

       "variables": {
            "variable": "pix_additional_info",
            "value": "[{\"nome\":\"Foo\",\"valor\":\"Bar\"}]"
        },
        {
            "variable": "pix_remittance_info",
            "value": "Teste info"
        }
    ],

Versão 3.1.12 disponível!

Acesse a nova versão por aqui e, antes de atualizar, desative qualquer versão anterior a 3.1.11.

Notas de atualização

• Correção: Removido avisos de incompatibilidade com parâmetros depreciados.
• Correção: Adicionada mensagem de incompatibilidade com "High-performance order storage".

Realizado a adição do parâmetro 'customer_minimum_balance_cents' no response da chamada https://api.iugu.com/v1/accounts/{id} .

     "informations": {
      "key": "customer_minimum_balance_cents",
      "value": "500"
    },

Agora é possível alterar os Métodos de Pagamento durante a alteração de um Plano da Assinatura

O parâmetro payable_with foi adicionado ao endpoint Alterar Plano da Assinatura — v1/subscriptions/{id}/change_plan/{plan_identifier}, permitindo que o Método de Pagamento daquela Assinatura também seja alterado. Antes, era necessário usar a API Editar Assinatura para, só então, utilizar este endpoint. Resultando em uma chamada a mais.

Abaixo um exemplo do objeto payable_with:

{
  "payable_with": [
    "pix, 
    credit_card, 
    bank_slip"
  ]
}

📘

E o all?

Também é possível utilizar o valor all se o Plano contar com todos os métodos.

Importante

Deve-se inserir apenas os métodos disponíveis no Plano especificado no parâmetro plan_identifier. Caso contrário, será retornado o erro a seguir:

422

{
  "payable_with": "são incompatíveis com o plano. Métodos disponíveis no plano: [método(s)]"
}

Dica💡

Utilize o endpoint Buscar Plano pelo Identificador ou Buscar Plano para consultar os métodos de pagamento do plano escolhido.

O banco 324 CARTOS SCD S.A. foi incluído como domicílio bancário.

Endpoints atualizados

Os endpoints que receberam esta atualização foram:

• Enviar Verificação de Subconta — v1/accounts/{account_id}/request_verification.
• Adicionar Domicílio Bancário — v1/bank_verification.

Adicionamos aos E-mails Transacionais um novo objeto: invoice.pix. Além disso, a propriedade bank_slip.bank_slip_url (URL do Boleto Bancário) ao objeto invoice.bank_slip.

Agora é possível ter acesso ao PDF do Boleto Bancário a partir do response de criação de fatura

Anteriormente, através do domínio faturas.iugu.com, era possível ter acesso ao PDF do Boleto Bancário inserindo '.pdf' ao final do URL.

Com a descontinuação deste domínio, o recurso foi migrado para o response da API Criar Fatura — POST v1/invoices através da propriedade bank_slip_pdf_url.

 "bank_slip": {

    "bank_slip_pdf_url": "https://boletos.iugu.com/v1/public/invoice/0bc8dbb7-0043-fb2-8fe3-417a0cfcd0d0-2bf9/bank_slip.pdf"
   
 }

Atualizado a documentação Tokenização de Cartão de Crédito com a informação da bandeira HiperCar.