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.

Agora é possível utilizar o return_url também no endpoint v1/subscriptions

Se durante a criação da Fatura, o parâmetro return_url foi informado e o cliente finaliza o pagamento utilizando o Checkout iugu, ele é redirecionado para este URL.

Antes, isto era um recurso exclusivo da API Criar Fatura — POST v1/invoices.

O banco 439 ID CORRETORA DE TÍTULOS E VALORES MOBILIÁRIOS S.A foi incluído como domicílio bancário.

Endpoints atualizados

Os endpoints que receberam esta atualização são:

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

Agora é possível ter acesso à imagem completa do boleto

Para isso, basta requisitar o endpoint Criar Fatura — POST v1/invoices e acessar o URL através da subpropriedade bank_slip_url:

"bank_slip": {
  
    "bank_slip_url": "https://boletos.iugu.com/v1/public/invoice/16f7aa3d-2e0b-41e9-987b-1dc95b957456-d7a2/bank_slip"
  
  }

📘

payable_with

Lembre-se de informar bank_slip ou all no parâmetro payable_with.

Além disso...

Esta propriedade também será exibida em todos endpoints de listagem e/ou consulta de faturas.

Agora é possível devolver os valores depositados via Pix

O endpoint Reembolsar Depósito Pix — v1/deposits/{id}/refund já está em produção! Para utilizá-lo, basta informar id do depósito que deseja reembolsar e requisitá-lo.

Importante

1. Este endpoind não devolve pix originados de Faturas.
2. Só é possível reembolsar o valor integral.
3. Só é possível devolver pix com status Aceito — accepted.
4. O processo de reembolso é assíncrono, então, logo após a requisição, seu status será alterado para processing_refund.

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

Endpoints atualizados

Os endpoints que receberam esta atualização são:

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