Metodos de Autenticacion
API Key
Autenticacion principal para integraciones servidor-a-servidor
X402 Protocol
Pago por uso sin necesidad de cuenta (solo lectura)
Stack Auth
Autenticacion de usuarios para el dashboard
API Key (Recomendado)
La autenticacion por API Key es el metodo principal y recomendado para la mayoria de las integraciones.1
Request
Tu app envia request con header
Authorization: Bearer pan_sk_xxx2
Validacion
Pan valida la API key y verifica el plan del developer
3
Creditos
Se deduce 1 credito del balance
4
Response
Respuesta incluye header
x-credits-remaining con creditos restantesFormato de API Key
Las API keys de Pan tienen el siguiente formato:- Prefijo:
pan_sk_(identifica que es una key de Pan) - Cuerpo: 64 caracteres hexadecimales (256 bits de entropia)
Como Usar
Incluye tu API key en el headerAuthorization de cada request:
Obtener tu API Key
- Inicia sesion en app.pan.dev
- Navega a Settings > API Keys
- Click en Create New Key
- Copia la key inmediatamente (solo se muestra una vez)
Multiples API Keys
Puedes crear multiples API keys para diferentes propositos:| Uso | Recomendacion |
|---|---|
| Desarrollo | Key separada con prefijo dev_ en metadata |
| Staging | Key separada con acceso limitado |
| Produccion | Key principal, bien protegida |
| CI/CD | Key con permisos minimos necesarios |
Revocar API Keys
Si sospechas que tu API key fue comprometida:- Ve a Settings > API Keys en el dashboard
- Encuentra la key comprometida
- Click en Revoke
- Crea una nueva key
- Actualiza tu aplicacion con la nueva key
Las keys revocadas dejan de funcionar inmediatamente. Asegurate de tener la nueva key lista antes de revocar la anterior.
Creditos y Facturacion
Cada request a Pan API consume creditos de tu cuenta:| Endpoint | Creditos |
|---|---|
POST /wallets | 1 |
GET /wallets/:id | 1 |
GET /balances/:id | 1 |
GET /yields | 1 |
POST /intents | 5 |
GET /intents/:id | 1 |
Planes y Limites
Free
- 100 creditos/mes
- 100 wallets max
- Solo testnets
Pro
- 10,000 creditos/mes
- 10,000 wallets max
- Mainnet habilitado
Enterprise
- Creditos ilimitados
- Wallets ilimitadas
- SLA dedicado
Verificar Creditos 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 Funciona
- Precio: Cada request cuesta $0.001 USD
- Pago: Se realiza en USDC en las redes soportadas (Base, Ethereum, Sei)
- Prueba: Incluyes un proof de pago en el header
X-Payment-Proof
Endpoints Soportados
Solo endpoints de lectura soportan X402:| Endpoint | X402 |
|---|---|
GET /wallets/:userId | Si |
GET /balances/:walletId | Si |
GET /yields | Si |
GET /intents/:intentId | Si |
POST /wallets | No |
POST /intents | No |
Ejemplo de Uso
Stack Auth (Dashboard)
Stack Auth se usa exclusivamente para autenticar usuarios en el dashboard web de Pan.Flujo de Autenticacion
1
Usuario visita dashboard
Accede a app.pan.dev
2
Redireccion a Stack Auth
El dashboard redirige al formulario de login
3
Usuario ingresa credenciales
Stack Auth valida 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:- Crea una nueva key
- Actualiza tu aplicacion para usar la nueva key
- Verifica que todo funcione
- Revoca la key anterior
6. Monitorea Uso Inusual
Revisa el dashboard periodicamente para detectar:- Picos de uso inesperados
- Requests desde IPs desconocidas
- Patrones de uso anomalos
7. Usa Keys Diferentes por Entorno
Manejo de Errores de Autenticacion
Error 401: Unauthorized
- API key faltante en el header
- API key mal formateada
- API key revocada
Error 403: Forbidden
- Excediste el limite de wallets de tu plan
- Intentas acceder a mainnet con plan free
- API key no tiene permisos para esta operacion
- Actualiza tu plan
- Revisa los limites de tu cuenta
