Authorization. Esta guía ofrece una descripción general de los conceptos de autenticación y los requisitos de seguridad.
La autenticación segura es fundamental para la integración de API. La autenticación basada en tokens de Localpayment garantiza que solo las solicitudes autorizadas puedan acceder a los datos de tu cuenta y procesar transacciones.
OAuth 2.0
Autenticación de token Bearer estándar de la industria
Tokens de corta duración
Tokens de acceso de 60 minutos para mayor seguridad
Requisitos de seguridad
Cifrado HTTPS
Toda comunicación API debe utilizar HTTPS para proteger los datos en tránsito.
Solo del lado del servidor
Las solicitudes de API deben originarse únicamente desde entornos de servidor seguros.
Lista blanca de IP
Configura la lista blanca de IP en el panel de control para autorizar las llamadas a la API.
Almacenamiento seguro de credenciales
Utiliza variables de entorno o sistemas de gestión de secretos.
Endpoints de autenticación
Gestiona la autenticación de tu API utilizando estos endpoints específicos:Obtén el token de acceso.
Obtén nuevos tokens de acceso y actualización utilizando tus credenciales de API.
Actualizar token de acceso
Obtén nuevos tokens de acceso usando tu token de actualización sin necesidad de volver a autenticarte.
Ejemplo rápido
Generar token:curl
curl
Caducidad del token
Localpayment utiliza tokens de corta duración para una mayor seguridad:Token de acceso
60 minutos
Se utiliza para las solicitudes a la API
Vida útil corta por seguridad
Se utiliza para las solicitudes a la API
Vida útil corta por seguridad
Token de actualización
120 minutos
Se utiliza para obtener nuevos tokens de acceso
Vida útil larga por comodidad
Se utiliza para obtener nuevos tokens de acceso
Vida útil larga por comodidad
Ciclo de vida del token
- Obtén los tokens: solicita un par de token de acceso y token de actualización con Obtener token de acceso.
- Reutiliza el token de acceso: envía el mismo token de acceso en cada solicitud mientras sea válido.
- Renueva al vencer: cuando el token de acceso venza o recibas una respuesta 401 Unauthorized, solicita un nuevo par con Obtener token de acceso.
- Reemplaza el par guardado: guarda ambos tokens nuevos y descarta los anteriores.
Uso del endpoint de actualizaciónEl endpoint Actualizar token de acceso sigue disponible si tu integración ya lo usa. Cada actualización correcta devuelve un nuevo par de tokens, y el token de actualización que enviaste deja de funcionar.Una nueva solicitud a Obtener token de acceso también invalida los tokens de actualización emitidos antes para el mismo usuario e integración.
Buenas prácticas para gestionar tokens
Un par de tokens por integración
Mantén un solo par de tokens por usuario e integración, compartido entre todos tus procesos y workers.
Reemplaza el par completo
Después de cada solicitud o actualización de token, guarda el nuevo token de acceso y el nuevo token de actualización.
Evita inicios de sesión en paralelo
No solicites tokens en paralelo con el mismo usuario. Cada nueva solicitud de token invalida los tokens de actualización anteriores.
No reintentes una actualización fallida
Si una actualización devuelve 401, solicita un nuevo token con Obtener token de acceso en lugar de reintentar con el mismo token de actualización.
Manejo de errores
401 Unauthorized
Token inválido o vencido
Solución: solicita un nuevo token con Obtener token de acceso. Si una actualización devuelve este error, no reintentes con el mismo token de actualización.
Solución: solicita un nuevo token con Obtener token de acceso. Si una actualización devuelve este error, no reintentes con el mismo token de actualización.
401 Unauthorized
IP no incluida en la lista blanca
Obtener token de acceso devuelve “Invalid IP for user. Please validate that 203.0.113.10 is whitelisted in your account settings.”
Solución: agrega la IP de tu servidor a la lista blanca en el panel de control.
Obtener token de acceso devuelve “Invalid IP for user. Please validate that 203.0.113.10 is whitelisted in your account settings.”
Solución: agrega la IP de tu servidor a la lista blanca en el panel de control.

