Skip to main content

Autenticación

Para comenzar a utilizar la API de Tupana, necesitarás configurar la autenticación correctamente. Utilizamos un sistema de API Keys para garantizar la seguridad de tus transacciones.

Obtener tu API Key

  1. Ingresa a tu panel de control
  2. Ve a “Configuración > API”
  3. Haz clic en “Generar Nueva API Key”
  4. Guarda tu API Key en un lugar seguro - no podrás verla nuevamente

Usar tu API Key

Headers de Autenticación

Para autenticarte con la API, incluye tu API Key en el header de tus peticiones usando el prefijo Api-Key:

Ejemplo en Python

Seguridad

Mejores Prácticas

  1. Nunca compartas tu API Key
  2. Rota tus API Keys regularmente
  3. Utiliza diferentes API Keys para producción y desarrollo
  4. Monitorea el uso de tus API Keys

Manejo de Errores

Si recibes un error de autenticación (401), verifica:
  1. Que estás usando la API Key correcta
  2. Que la API Key no ha expirado
  3. Que el formato del header es correcto (debe ser Authorization: Api-Key TU_API_KEY)
  4. Que la API Key está activa en tu panel de control

Siguientes Pasos

Una vez configurada la autenticación, puedes:
  1. Emitir tu primer documento
  2. Explorar los endpoints disponibles
  3. Configurar webhooks para notificaciones