Setup: autenticación y entornos
Antes de recibir pagos necesitas dos cosas: un token para autenticarte y saber contra qué entorno apuntas.
Autenticación
La API Productos usa Bearer token. Lo obtienes al iniciar sesión:
curl -X POST https://sandbox.api.spidipagos.com/api/spidipagos/login \
-H "Content-Type: application/json" \
-d '{"short_name":"<TU_USUARIO>","password":"<TU_CLAVE>"}'
La respuesta trae token (y un refreshToken). Envía el token en cada llamada:
Authorization: Bearer <token>
En el simulador no necesitas credenciales
Para aprender y probar, el simulador hosteado te da una cuenta de prueba con su token directo al registrarte (POST /register) — sin login real. Trabajas en tu propio espacio aislado.
A confirmar con SPIDI (no bloquea): el
refreshTokenque ya emite el login no está documentado; asumimos volver a iniciar sesión cuando el token caduque.
Entornos
| Entorno | URL base (Productos) | Para qué |
|---|---|---|
| Simulador | https://sim-productos.abiertolab.com | Aprender y probar sin dinero real |
| Sandbox | https://sandbox.api.spidipagos.com | Pruebas contra el entorno de SPIDI |
| Producción | (por confirmar) | Pagos reales |
La OpenAPI declara hoy solo el sandbox; la URL de producción es un dato que SPIDI agrega al contrato. Ver Entornos y URLs.
Siguiente paso
Con tu token listo → Recibe tu primer pago.