Introdução à API

Confira uma breve introdução das APIs da iugu.

A iugu oferece uma interface de programação web no modelo REST, permitindo interação eficiente com seu sistema. Com essa API, você pode executar comandos, verificar configurações e sincronizar dados com seus próprios sistemas.

A comunicação é feita através do endereço base https://api.iugu.com, utilizando sempre o protocolo seguro https://. As versões da API são organizadas em diretórios específicos, sufixados ao endereço base (por exemplo, https://api.iugu.com/v1.


Postman Collection

Além das referências em dev.iugu.com/referece, disponibilizamos uma Collection do Postman:

Atualizado em 04/12/24

Notas de atualização

  • Adicionado o objeto files com os parâmetros: identification, selfie, address_proof, social_contract, balance_sheet, additional_document_one e additional_document_two no endpoint POST /v1/accounts/{account_id}/request_verification. Saiba mais.
  • Adicionado o objeto splits no endpoint POST /v1/subscriptions. Saiba mais.

Autenticação

A autenticação na iugu é realizada por meio de uma chave de API, que permite ao sistema identificar a sua conta e conceder as permissões necessárias para a comunicação com a iugu em nome da conta associada. Saiba mais.


Produção e Teste

A distinção de um ambiente de produção ou teste será feita através do api_token que for utilizado no momento da requisição. Crie um api_token e utilize de acordo com com sua necessidade.


IP de saída da iugu

Para aqueles que fazem controle dos IPs em seu Firewall, por exemplo, considere permitir o 54.207.210.151.


Tabela de Erros

Disponibilizamos também uma tabela dos principais erros e seus motivos para consulta neste link.


Recipes

Acesse a nossa biblioteca de Recipes. Um jeito prático e dinâmico de como utilizar as nossas APIs para determinados objetivos.


Paginação

Para APIs de listagem, são utilizados parâmetros de paginação. Saiba mais.


Atualizações

Sempre que uma nova feature ou atualização acontece, informamos os detalhes em nossa Página de Atualizações.


Status da iugu

Tenha acesso ao status dos serviços da iugu em tempo real em status.iugu.com.


Obter suporte

Se precisar de ajuda técnica, entre em contato com o nosso Suporte Técnico.