Api key Comercio

Crear API Keys

POST /v1/api-keys

Este endpoint permite crear una api key para un comercio determinado.

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

Authorization: Bearer example_access_token_comercio

¿Ya tienes una API Key disponible? Entonces puedes hacer la solicitud incluyendo el siguiente header.

X-Api-Key: api_key_comercio
ParámetrosDescripción
user
  • string
  • Email del comercio. Debe estar en minúsculas: las mayúsculas se rechazan con 400
customer_id
  • (opcional)
  • string
  • Identificador del cliente
merchant_id
  • (opcional)
  • string
  • Identificador del comercio
country
  • (opcional)
  • string
  • País del comercio
ℹ️

Con credenciales MERCHANT solo se pueden crear API Keys de comercio. Con credenciales CUSTOMER, si se omite merchant_id se crea una API Key de tipo CUSTOMER en lugar de una de comercio.

ℹ️
  • Si no existe un usuario para ese email, se crea uno de servicio de forma automática. Si el usuario está deshabilitado, la solicitud responde 422.
  • Solo se cuentan las API Keys en estado ENABLED: el máximo es 10 por usuario y, al superarlo, la solicitud responde 422.
  • El valor completo de api_key solo se devuelve en esta respuesta (201). El listado lo devuelve enmascarado.
  • Pueden ocurrir además errores 400 de validación del body.
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}"
    }'
  {
      "id": "string",
      "api_key": "string",
      "user": "string",
      "user_type": "MERCHANT",
      "customer_id": "string",
      "merchant_id": "string",
      "status": "ENABLED",
      "create_date": "2025-05-27T15:18:14.198056093Z",
      "update_date": "2025-05-27T15:18:14.205319483Z"
  }
EliminarBuscar