Autenticación

Autenticación

Los servicios API de Menta brindan todos los recursos necesarios para desarrollar integraciones que permitan operar eficientemente con nuestras plataformas.

Formas de autenticación

Nuestra API ofrece dos métodos de autenticación:

  1. Usuario y Contraseña (Token)
  2. Clave de acceso (API Key)

1. Autenticación con Usuario y Contraseña

Este método requiere credenciales de tipo CUSTOMER, las cuales son enviadas por correo electrónico por el equipo de Menta o generadas desde el Back Office por otro usuario autorizado. Una vez obtenidas, se debe iniciar sesión utilizando estas credenciales para recibir un token de acceso, el cual es necesario para autenticar todas las solicitudes posteriores.

✅ Requisitos

  • Contar con un usuario válido de tipo CUSTOMER y su contraseña correspondiente.

🎯 Resultado

  • Token de autenticación que se debe usar en cada solicitud mientras esté vigente.

🔗 Endpoint de autenticación

POST https://api.menta.global/api/v1/login

📦 Ejemplo de solicitud

curl --request POST \
  --url https://api.menta.global/api/v1/login \
  --header 'Content-Type: application/json' \
  --data '{
    "user": "usuario",
    "password": "contraseña"
  }'

📥 Respuesta esperada

{
    "token": {
        "access_token": "example access_token",
        "token_type": "Bearer",
        "expires_in": 3600
        ...
    }
}
ℹ️

El token recibido debe almacenarse de forma segura, ya que permite acceder a todas las funcionalidades habilitadas para el usuario autenticado. Tené en cuenta que el token tiene una fecha de expiración(expires_in). Es fundamental renovarlo antes de que caduque para evitar interrupciones en las operaciones.

Uso del Token de Acceso

El token debe incluirse en la cabecera Authorization de cada petición como un Bearer Token.

Authorization: Bearer example_access_token
Ejemplo:
curl --request GET \
  --url https://api.menta.global/api/v1/users \
  --header 'Authorization: Bearer example_access_token'

2. Autenticación con API Key

Este método te permite conectarte con nuestra plataforma sin tener que usar usuario y contraseña cada vez. En su lugar, se usa una API Key, que funciona como una llave segura.

🔐 ¿Cómo conseguir tu API Key?

Podés pedir tu API Key al equipo de Menta o generarla vos mismo si ya tenés acceso como cliente o comercio.

💡 Recomendamos usar un correo exclusivo para esta integración, diferente al que usás para ingresar con usuario y contraseña. Son formas de acceso distintas y no se mezclan.

🔗 A) Si sos CLIENTE

Podés solicitar tu API Key directamente a Menta o generarla vos mismo en pocos pasos usando el token de acceso que vimos anteriormente. A continuación, te compartimos el endpoint que vas a necesitar.

POST  https://api.menta.global/api/v1/api-keys

📦 Ejemplo de solicitud.

¿Es la primera vez que generás una API Key? En ese caso, deberás incluir el siguiente header en tu solicitud.

Authorization: Bearer example_access_token_cliente
curl --request POST \
  --url https://api.menta.global/api/v1/api-keys \
  --header 'Authorization: Bearer example_access_token_cliente' \
  --data '{
    "user": "email_cliente",
    "customer_id": "{id_cliente}"
  }'

¿Ya tenés una API Key disponible? Entonces podés hacer la solicitud incluyendo el siguiente header.

X-Api-Key: api_key_cliente
curl --request POST \
  --url https://api.menta.global/api/v1/api-keys \
  --header 'X-Api-Key: api_key_cliente' \
  --data '{
    "user": "email_cliente",
    "customer_id": "{id_cliente}"
  }'

📥 Respuesta esperada

{
    "id": "identificador_api_key",
    "api_key": "api_key_cliente",
    "user": "email_cliente",
    "user_type": "CUSTOMER",
    "customer_id": "{id_cliente}"
    ...
}

¿Necesitar crear api-key a tus comercios? Entonces podés hacer la solicitud incluyendo el siguiente header.

X-Api-Key: api_key_cliente
curl --request POST \
  --url https://api.menta.global/api/v1/api-keys \
  --header 'X-Api-Key: api_key_cliente' \
  --data '{
      "user": "[email protected]",
      "customer_id": "{id_cliente}",
      "merchant_id": "{id_comercio}"
    }'

🔧 B) Si sos COMERCIO

También se puede generar una API Key para comercios, de la misma forma que para clientes.

POST  https://api.menta.global/api/v1/api-keys

📦 Ejemplo de solicitud

¿Es la primera vez que generás una API Key? En ese caso, deberás incluir el siguiente header en tu solicitud.

Authorization: Bearer example_access_token_comercio
curl --request POST \
  --url https://api.menta.global/api/v1/api-keys \
  --header 'Authorization: Bearer example_access_token_comercio' \
  --data '{
      "user": "[email protected]",
      "customer_id": "{id_cliente}",
      "merchant_id": "{id_comercio}"
    }'

¿Ya tenés una API Key disponible? Entonces podés hacer la solicitud incluyendo el siguiente header.

X-Api-Key: api_key_comercio
curl --request POST \
  --url https://api.menta.global/api/v1/api-keys \
  --header 'X-Api-Key: api_key_comercio' \
  --data '{
      "user": "[email protected]",
      "customer_id": "{id_cliente}",
      "merchant_id": "{id_comercio}"
    }'

📥 Respuesta esperada

{
  "id": "identificador_api_key",
  "api_key": "api_key_comercio",
  "user": "email_comercio",
  "user_type": "MERCHANT",
  "merchant_id": "{id_comercio}",
  "customer_id": "{id_cliente}",
  ...
}
ℹ️

Podés tener hasta 10 API Keys por usuario.

¿Querés más información sobre cómo gestionar tus API Keys?

a)Si sos CLIENTE

a)Si sos COMERCIO

¿Necesitás ayuda?

📬

Si todavía no tenés tus credenciales o querés que te ayudemos con la integración, escribinos a: 📩 [email protected]