Api key Cliente

Crear API Keys

POST /v1/api-keys

Este endpoint permite crear una api key para un comercio asociado a un cliente. El tipo de API Key se deriva del body: si se envía merchant_id se crea una de tipo MERCHANT; si no, una de tipo CUSTOMER. El request no tiene un campo user_type.

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. Si se omite, se crea una API Key de tipo CUSTOMER en lugar de una de comercio
country
  • (opcional)
  • string
  • País (por ejemplo ARG)
ℹ️
  • 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_cliente' \
  --data '{
    "user": "email_comercio",
    "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"
  }
AutogestiónBuscar