FAQ

¿Hay SDK oficial?

No. La API REST es simple y cabe en las bibliotecas HTTP estándar de cada lenguaje. Ver Ejemplos por lenguaje.

¿Puedo probar antes de tener el KYC aprobado?

No. La creación de API keys exige KYC aprobado y correo verificado. Sin eso, no puedes generar credenciales.

¿Los valores van en reales o en centavos?

Centavos, siempre. R$ 10,00 = 1000. Ver todos los campos monetarios en la Referencia.

¿Cómo pruebo localmente sin exponer un endpoint público para webhook?

Usa una herramienta de túnel HTTPS (p.ej. ngrok, Cloudflare Tunnel) para exponer tu localhost. Registra la URL pública generada en el panel de INFI.

¿Por cuánto tiempo intenta INFI entregar un webhook?

Una sola tentativa, con timeout de 8 segundos. Si tu aplicación no responde, el evento se pierde. Implementa siempre un fallback vía GET /v1/transactions/:id. Ver Reintento.

¿Puedo tener más de una API key activa?

Sí — hasta 10 activas por defecto (ajustable). Usa una por aplicación o microservicio para rotación sin indisponibilidad. Ver Rotación de API keys.

¿Qué pasa si repito el mismo externalRef?

INFI devuelve el cobro original con "idempotent": true, sin crear duplicado. Ver Idempotencia.

¿Puedo hacer retiros a cualquier clave PIX?

Sí para email, phone y evp válidos. Para cpf y cnpj, la clave debe coincidir con el responsable/empresa registrados en tu cuenta INFI. Ver Claves PIX aceptadas.

¿El saldo es instantáneo tras pagarse un cobro?

Consistencia eventual. El available en GET /v1/balance refleja el crédito en pocos segundos. Para conciliación inmediata, usa GET /v1/transactions/:id.

¿Necesito activar 2FA en mi cuenta para usar la API?

No. El 2FA (TOTP) disponible en el panel no afecta a la API REST. Tu integración sigue autenticándose solo con la API key — independientemente de si tienes 2FA activado o no. Los retiros vía POST /v1/withdraw no exigen código TOTP. Ver la nota en Autenticación.