> ## Documentation Index
> Fetch the complete documentation index at: https://docs.localpayment.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Descripción general de la autenticación

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.

> [card] OAuth 2.0
>
> Autenticación de token Bearer estándar de la industria

> [card] Tokens de corta duración
>
> Tokens de acceso de 60 minutos para mayor seguridad

***

## Requisitos de seguridad

> [!WARNING]
>
> **Requisitos críticos de seguridad**
>
> Sigue estas prácticas para garantizar una integración segura de la API.

> [card] Cifrado HTTPS
>
> Toda comunicación API debe utilizar HTTPS para proteger los datos en tránsito.

> [card] Solo del lado del servidor
>
> Las solicitudes de API deben originarse únicamente desde entornos de servidor seguros.

> [card] Lista blanca de IP
>
> Configura la lista blanca de IP en el panel de control para autorizar las llamadas a la API.

> [card] 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:

> [card] [Obtén el token de acceso.](https://docs.localpayment.com/es/reference/get-token.md)
>
> Obtén nuevos tokens de acceso y actualización utilizando tus credenciales de API.

> [card] [Actualizar token de acceso](https://docs.localpayment.com/es/reference/refresh-token.md)
>
> Obtén nuevos tokens de acceso usando tu token de actualización sin necesidad de volver a autenticarte.

### Ejemplo rápido

**Generar token:**

```bash curl theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
curl --request POST \
     --url https://api.stage.localpayment.com/api/token/ \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "username": "user@example.com",
  "password": "<PASSWORD>"
}
'
```

**Usar token:**

```bash curl theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
curl --request POST \
     --url https://api.stage.localpayment.com/api/validation/document \
     --header 'Authorization: Bearer <your_access_token>' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "country": "ARG",
  "document": {
    "id": "1791234561009",
    "type": "RUC"
  }
}
'
```

***

## Caducidad del token

Localpayment utiliza tokens de corta duración para una mayor seguridad:

> [card] Token de acceso
>
> **60 minutos**\\
>
> Se utiliza para las solicitudes a la API\\
>
> Vida útil corta por seguridad

> [card] 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](https://docs.localpayment.com/es/reference/get-token.md).
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.

> [!TIP]
>
> **Uso del endpoint de actualización**
>
> El endpoint [Actualizar token de acceso](https://docs.localpayment.com/es/reference/refresh-token.md) 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

> [card] 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.

> [card] 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.

> [card] 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.

> [card] 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

> [card] 401 Unauthorized
>
> **Token inválido o vencido** \\
>
> Solución: solicita un nuevo token con [Obtener token de acceso](https://docs.localpayment.com/es/reference/get-token.md). Si una actualización devuelve este error, no reintentes con el mismo token de actualización.

> [card] 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](https://docs.localpayment.com/es/docs/dashboard-whitelist-your-ips.md) en el panel de control.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.