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/11/24

Notas de atualização

Parâmetros de RSA no header: Signature e Request-Time foram adicionados no header dos endpoints:

API Endpoint
Criar Subconta v1/marketplace/create_account
Configurar Conta v1/accounts/configuration
Adicionar Domicílio Bancário v1/bank_verification

Estes passarão a ser obrigatórios a partir do dia 07/11/24.

API	Endpoint
Criar Subconta	`v1/marketplace/create_account`
Configurar Conta	`v1/accounts/configuration`
Adicionar Domicílio Bancário	`v1/bank_verification`

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.