Autenticación
Cada llamada a la API lleva una clave secreta sw_live_, creada en Ajustes › Integraciones y mostrada una sola vez. 120 peticiones por minuto y por clave.
Crear una clave
- Abre Ajustes › Integraciones en tu espacio de StampyWallet (el propietario o un encargado).
- Crea una clave y ponle un nombre que diga dónde se usa («Caja del mostrador», «Web»).
- Cópiala enseguida. Empieza por
sw_live_y solo se muestra completa una vez: StampyWallet solo guarda una huella. Si la pierdes, no se puede recuperar: revócala y crea otra.
Enviarla en cada llamada
La clave va en la cabecera Authorization, después de la palabra Bearer:
Authorization: Bearer sw_live_4f9c2a7e1b...Una clave da acceso a un comercio: aquel en el que se creó. Si gestionas varios establecimientos, crea una clave en cada uno.
Atención : la clave actúa en tu nombre: crea clientes y añade visitas. Guárdala en el servidor (variable de entorno, gestor de secretos), nunca en el código de una página web o de una aplicación móvil, nunca en un repositorio Git.
Revocar una clave
En Ajustes › Integraciones, revoca la clave: las llamadas que la lleven fallan al instante con 401 y el código cle_revoquee. Hazlo en cuanto una clave haya podido filtrarse, o cuando un proveedor ya no la necesite.
Los errores de acceso
| Estado | code | Cuándo |
|---|---|---|
401 | non_authentifie | Cabecera ausente o clave desconocida |
401 | cle_revoquee | La clave se ha revocado |
403 | formule_requise | El comercio no tiene el plan Crecimiento (la API está incluida, y abierta durante la prueba) |
403 | interdit | La acción no está permitida para este comercio |
429 | trop_de_requetes | Más de 120 peticiones por minuto con esta clave |
El límite de peticiones
120 peticiones por minuto y por clave. Por encima, la respuesta es 429 con la cabecera Retry-After: 60: espera ese número de segundos antes de seguir. Un TPV normal está muy lejos de ese límite.
El detalle del formato de los errores está en la página Errores.
Actualizado el