FAQ

Existe SDK oficial?

Não. A API REST é simples e cabe nas bibliotecas HTTP padrão de cada linguagem. Veja Exemplos por linguagem.

Posso testar antes de ter KYC aprovado?

Não. A criação de API keys exige KYC aprovado e e-mail verificado. Sem isso, você não consegue gerar credenciais.

Os valores são em reais ou centavos?

Centavos, sempre. R$ 10,00 = 1000. Veja todos os campos monetários na Referência.

Como testar localmente sem expor um endpoint público para webhook?

Use uma ferramenta de tunelamento HTTPS (ex.: ngrok, Cloudflare Tunnel) para expor seu localhost. Cadastre a URL pública gerada no painel da INFI.

Por quanto tempo a INFI tenta entregar um webhook?

Apenas uma tentativa, com timeout de 8 segundos. Se sua aplicação não responder, o evento é perdido. Sempre implemente fallback via GET /v1/transactions/:id. Veja Retentativa.

Posso ter mais de uma API key ativa?

Sim — até 10 ativas por padrão (ajustável). Use uma por aplicação ou microserviço para rotação sem indisponibilidade. Veja Rotação de API keys.

O que acontece se eu repetir a mesma externalRef?

A INFI retorna a cobrança original com "idempotent": true, sem criar duplicata. Veja Idempotência.

Posso fazer saque para qualquer chave PIX?

Sim para email, phone e evp válidos. Para cpf e cnpj, a chave deve coincidir com o responsável/empresa cadastrados na sua conta INFI. Veja Chaves PIX aceitas.

O saldo é instantâneo após uma cobrança ser paga?

Eventualmente consistente. O available em GET /v1/balance reflete o crédito em poucos segundos. Para reconciliação imediata, use GET /v1/transactions/:id.

Preciso ativar 2FA na minha conta para usar a API?

Não. O 2FA (TOTP) disponível no painel não afeta a API REST. Sua integração continua autenticando apenas com a API key — independentemente de ter 2FA ativada ou desativada na conta. Saques via POST /v1/withdraw não exigem código TOTP. Veja a nota em Autenticação.