Skip to main content
pan API soporta múltiples métodos de autenticación para diferentes casos de uso. Esta guía cubre todos los métodos disponibles, cuando usar cada uno, y mejores prácticas de seguridad.

Métodos de Autenticación

API Key

Autenticación principal para integraciones servidor-a-servidor

X402 Protocol

Pago por uso sin necesidad de cuenta (solo lectura)

Stack Auth

Autenticación de usuarios para el dashboard

API Key (Recomendado)

La autenticación por API Key es el método principal y recomendado para la mayoria de las integraciones.
1

Request

Tu app envia request con header Authorization: Bearer pan_sk_xxx
2

Validación

pan válida la API key y verifica el plan del developer
3

Creditos

Se deduce 1 crédito del balance
4

Response

Respuesta incluye header x-credits-remaining con créditos restantes

Formato de API Key

Las API keys de pan tienen el siguiente formato:
  • Prefijo: pan_sk_ (identifica qué es una key de pan)
  • Cuerpo: 64 caracteres hexadecimales (256 bits de entropía)

Como Usar

Incluye tu API key en el header Authorization de cada request:

Obtener tu API Key

  1. Inicia sesion en app.pan.tech
  2. Navega a Settings > API Keys
  3. Click en Create New Key
  4. Copia la key inmediatamente (solo se muestra una vez)
Guarda tu API key de forma segura. No podras verla de nuevo después de cerrar el modal. Si la pierdes, deberas crear una nueva.

Múltiples API Keys

Puedes crear múltiples API keys para diferentes propositos:

Revocar API Keys

Si sospechas que tu API key fue comprometida:
  1. Ve a Settings > API Keys en el dashboard
  2. Encuentra la key comprometida
  3. Click en Revoke
  4. Crea una nueva key
  5. Actualiza tu aplicación con la nueva key
Las keys revocadas dejan de funcionar inmediatamente. Asegurate de tener la nueva key lista antes de revocar la anterior.

Créditos y Facturación

Cada request a pan API consume créditos de tu cuenta:

Planes y Limites

Free

  • 100 creditos/mes
  • 100 wallets max
  • Solo testnets

Pro

  • 10,000 creditos/mes
  • 10,000 wallets max
  • Mainnet habilitado

Enterprise

  • Créditos ilimitados
  • Wallets ilimitadas
  • SLA dedicado

Verificar Créditos Restantes

X402 Protocol (Pago por Uso)

X402 es un protocolo de micropagos que permite usar la API sin crear una cuenta, pagando por cada request.

Cuando Usar X402

Usar X402

  • Integraciones de prueba rapida
  • Acceso anonimo a la API
  • Endpoints de solo lectura
  • Cuando no quieres manejar API keys

No Usar X402

  • Operaciones de escritura (crear wallets, intents)
  • Produccion con alto volumen
  • Cuando necesitas tracking detallado

Como Funcióna

  1. Precio: Cada request cuesta $0.001 USD
  2. Pago: Se realiza en USDC en las redes soportadas (Base, Ethereum, Sei)
  3. Prueba: Incluyes un proof de pago en el header X-Payment-Proof

Endpoints Soportados

Solo endpoints de lectura soportan X402:

Ejemplo de Uso

X402 no está disponible para operaciones de escritura. Para crear wallets o intents, debes usar API Key.

Stack Auth (Dashboard)

Stack Auth se usa exclusivamente para autenticar usuarios en el dashboard web de pan.

Flujo de Autenticación

1

Usuario visita dashboard

Accede a app.pan.tech
2

Redirección a Stack Auth

El dashboard redirige al formulario de login
3

Usuario ingresa credenciales

Stack Auth válida el usuario
4

Sesion creada

Stack Auth retorna token, dashboard crea sesion y carga

No Usar para API

Stack Auth no es para llamadas programaticas a la API. Usa siempre API Key para integraciones servidor-a-servidor.

Seguridad: Mejores Practicas

1. Nunca Expongas tu API Key

MAL

BIEN

2. Usa Variables de Entorno

3. Agrega .env a .gitignore

4. Usa Secretos en CI/CD

5. Rota Keys Periodicamente

Recomendamos rotar tus API keys cada 90 dias:
  1. Crea una nueva key
  2. Actualiza tu aplicación para usar la nueva key
  3. Verifica que todo funcione
  4. Revoca la key anterior

6. Monitorea Uso Inusual

Revisa el dashboard periódicamente para detectar:
  • Picos de uso inesperados
  • Requests desde IPs desconocidas
  • Patrones de uso anomalos

7. Usa Keys Diferentes por Entorno

Manejo de Errores de Autenticación

Error 401: Unauthorized

Causas comunes:
  • API key faltante en el header
  • API key mal formateada
  • API key revocada
Solución:

Error 403: Forbidden

Causas comunes:
  • Excediste el límite de wallets de tu plan
  • Intentas acceder a mainnet con plan free
  • API key no tiene permisos para está operación
Solución:
  • Actualiza tu plan
  • Revisa los límites de tu cuenta

Error 429: Rate Limited

Headers de respuesta:
Solución:

Próximos Pasos

Crear Wallets

Aprende a crear y gestionar wallets

Ejecutar Intents

Ejecuta tu primera operación DeFi

Seguridad

Guía completa de seguridad

Referencia API

Documentación completa de endpoints