Saltar al contenido principal
Localpayment utiliza la autenticación mediante token Bearer de OAuth 2.0 para proteger el acceso a la API. Todas las solicitudes a la API requieren un token de acceso válido incluido en el encabezado 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

Requisitos críticos de seguridadSigue estas prácticas para garantizar una integración segura de la API.

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
Usar token:
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

Token de actualización

120 minutos
Se utiliza para obtener nuevos tokens de acceso
Vida útil larga por comodidad

Ciclo de vida del token

  1. Obtén los tokens: solicita un par de token de acceso y token de actualización con Obtener token de acceso.
  2. Reutiliza el token de acceso: envía el mismo token de acceso en cada solicitud mientras sea válido.
  3. Renueva al vencer: cuando el token de acceso venza o recibas una respuesta 401 Unauthorized, solicita un nuevo par con Obtener token de acceso.
  4. 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.

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.
Última modificación el 12 de noviembre de 2026