La API de Autenticación de Cobre está diseñada específicamente para que los clientes interactúen con Cobre con las mejores capacidades de autenticación más seguras y sin fricciones, facilitando así el acceso a la plataforma Cobre Move Money. Esta API simplifica el proceso de autenticación mediante un enfoque directo que requiere solo un user_id y un secret. Estas credenciales, obtenidas dentro del ecosistema de Cobre, garantizan una vía de autenticación segura y eficiente.

Guía de la API de Authentication de Cobre

La API de Autenticación de Cobre facilita interacciones seguras dentro de la plataforma Cobre Money Movement. Sigue esta guía paso a paso para autenticarte y usar los servicios de la plataforma de manera efectiva.

Obtener credenciales de API

Antes de poder autenticarte, necesitas obtener las credenciales de API necesarias: un user_id y un secret. Estas credenciales se proporcionan dentro del ecosistema de Cobre, asegurando una forma segura y directa de acceder a la plataforma.

Autenticarse en la plataforma

Con tus credenciales de API en mano, úsalas para autenticarte en la plataforma. Envía una solicitud al endpoint de la API de Authentication, incluyendo tu user_id y secret. Al autenticarte exitosamente, la API retornará un JSON Web Token (JWT).

Ejemplo de solicitud de autenticación:

POST /auth
Content-Type: application/json

{
  "user_id": "your_user_id",
  "secret": "your_secret"
}

Ejemplo de respuesta de autenticación:

{
    "access_token": "eyJhbGciOiJSUzI1...",
    "type": "Bearer",
    "expiration_time": 1200
}

¡Comienza a mover dinero!

Con el token JWT en mano, podrás iniciar todas tus operaciones de movimiento de dinero!

Cómo empezar

Antes de comenzar, recomendamos tener claridad sobre los pasos preliminares requeridos antes de usar esta solución.

Antes de usar esta API

Crea tus credenciales de API desde el Portal

Accede al Portal y encuentra la sección Developers en la parte inferior del menú lateral izquierdo.

Una vez en la sección Developers, haz clic en la pestaña de credenciales de API, luego en + Create Credential.

Una nueva ventana aparecerá. Asigna un alias y selecciona el rol para crear tu credencial de API con el acceso necesario.

Una vez que se genere la credencial, asegúrate de almacenarla en un lugar seguro ya que no será posible obtenerla nuevamente.

Qué esperar después de usar esta API

Comenzar a llamar las APIs de Cobre

Ve las siguientes secciones para aprender más sobre las APIs de Cobre.

Manejar la expiración del token

Gestión y almacenamiento en caché de tokens:

No solicites un nuevo token para cada llamada de API de negocio. Esto es ineficiente y puede causarte bloqueos debido a la limitación de velocidad.

Almacena en caché el access_token después de obtenerlo.

Antes de hacer una llamada a la API de negocio, verifica si el token en caché ha expirado. Se recomienda solicitar un nuevo token un poco antes de que expire (ej., 3 minutos antes) para evitar fallas por expiración.

Por qué importa la gestión del ciclo de vida del token

Las APIs de Cobre usan tokens de acceso de corta duración, por lo que tu integración debe manejar la renovación de tokens de manera controlada:

No solicites un nuevo token en cada llamada de API

En su lugar, almacena el token en caché, reutilízalo y renóvalo solo cuando esté cerca de expirar

Implementa un único "administrador de tokens" que compartan todas las solicitudes de API de Cobre

Esto proporciona:

Menor latencia (menos llamadas de autenticación)

Rendimiento más estable

Manejo de errores y observabilidad más limpios

Mejor resistencia bajo carga

La estrategia recomendada

1) Almacenar en caché el token y su timestamp de expiración

Cuando solicitas un token, la respuesta incluye:

un access token

una duración de expiración (a menudo expires_in)

Tu integración debe calcular y almacenar:

token

expires_at = now + expires_in

Almacena tokens en memoria cuando sea posible (más rápido).
Si ejecutas múltiples instancias, considera un caché compartido (Redis, Memcached) para que todas las réplicas reutilicen el mismo token.

2) Renovar "justo a tiempo" usando una ventana de seguridad

En lugar de esperar hasta que expire, renueva un poco antes.

Ventana de seguridad recomendada: renovar si el token expira dentro de los próximos 60–120 segundos.

Esto asegura:

que ningún token expire durante solicitudes lentas

que no haya casos límite debido a deriva de reloj

que no haya ráfagas de 401 en escenarios de alta concurrencia

3) Forzar una sola renovación a la vez (evitar tormentas de tokens)

Si tu sistema hace solicitudes paralelas, debes evitar múltiples renovaciones simultáneas de tokens (a menudo llamada "tormenta de tokens").

Usa un lock / mutex para asegurar que solo ocurra una renovación, y que todas las otras solicitudes esperen por ella.

Implementación de referencia (pseudocódigo independiente del lenguaje)

Usa esta lógica antes de cada solicitud a Cobre:

function getValidToken():
  if cached_token exists AND now < cached_expires_at - safety_window:
      return cached_token

  lock(token_refresh_lock):
      # Double-check after acquiring lock
      if cached_token exists AND now < cached_expires_at - safety_window:
          return cached_token

      response = requestNewToken()
      cached_token = response.access_token
      cached_expires_at = now + response.expires_in
      return cached_token

Conoce la documentación técnica de nuestra API de Authentication:

API de Autenticación

Obtén tokens de autenticación para comenzar a usar las APIs de Cobre

Autenticación

Guía de la API de Authentication de Cobre#

Cómo empezar#

Antes de usar esta API#

Crea tus credenciales de API desde el Portal#

Qué esperar después de usar esta API#

Gestión y almacenamiento en caché de tokens:#

Por qué importa la gestión del ciclo de vida del token#

La estrategia recomendada#

1) Almacenar en caché el token y su timestamp de expiración#

2) Renovar "justo a tiempo" usando una ventana de seguridad#

3) Forzar una sola renovación a la vez (evitar tormentas de tokens)#

Implementación de referencia (pseudocódigo independiente del lenguaje)#

Guía de la API de Authentication de Cobre

Cómo empezar

Antes de usar esta API

Crea tus credenciales de API desde el Portal

Qué esperar después de usar esta API

Gestión y almacenamiento en caché de tokens:

Por qué importa la gestión del ciclo de vida del token

La estrategia recomendada

1) Almacenar en caché el token y su timestamp de expiración

2) Renovar "justo a tiempo" usando una ventana de seguridad

3) Forzar una sola renovación a la vez (evitar tormentas de tokens)

Implementación de referencia (pseudocódigo independiente del lenguaje)