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.

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.

🚧
Importante
O endpoint de test está sujeito a um limite de uso de 50 requisições por minuto. Requisições que excederem esse limite receberão uma resposta com o código HTTP 429 - Too Many Requests.
Recomendamos o uso de Mocks em testes automatizados para evitar restrições e garantir maior controle em seus fluxos de validação. Saiba mais.
Limite de 1000 faturas test por dia
A rota Criar Fatura — POST /v1/invoice tem um limite de até 1000 faturas por dia. Essa medida tem como principal objetivo manter a estabilidade dos nossos serviços.

IP de saída da iugu

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

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.