Usuarios

Crear usuario

POST /v1/users

Permite crear usuarios para una empresa o comercio. Disponible con credenciales CUSTOMER; con credenciales MERCHANT la respuesta es 403.

ParámetrosDescripción
user_type
  • string
  • El tipo de usuario que se quiere crear
  • [MERCHANT, CUSTOMER]
password
  • (opcional)
  • string
  • Una contraseña inicial temporal, se solicitará un cambio en el primer login.
attributes
  • object
  • Datos del usuario. Los campos siguientes van dentro de este objeto
  • attributes.
email
  • string
  • El email del usuario. No admite caracteres no permitidos (solo letras, números y !#$%&'*+-/=?^_`{|}~) y tiene un máximo de 254 caracteres
  • attributes.
name
  • (opcional)
  • string
  • Nombre del usuario
  • attributes.
username
  • (opcional)
  • string
  • Nombre de usuario
  • attributes.
description
  • (opcional)
  • string
  • Descripción del usuario
  • attributes.
customer_id
  • (opcional)
  • array
  • Identificadores de los clientes a los que pertenece un usuario, como array JSON de UUID. Se envía para usuarios MERCHANT y CUSTOMER
  • attributes.
merchant_id
  • (opcional)
  • array
  • Identificadores de los comercios a los que pertenece un usuario, como array JSON de UUID. Se envía para usuarios MERCHANT; se omite para CUSTOMER
  • attributes.
scope
  • (opcional)
  • string
  • El tipo de permiso que se le quiere asignar (si no es enviado, por defecto es FULL_ACCESS)
  • [WITHOUT_GROUPS, READ_ONLY, FULL_ACCESS, BASIC]
ℹ️
  • Un usuario MERCHANT requiere customer_id y merchant_id. Un usuario CUSTOMER requiere customer_id y no debe incluir merchant_id.
  • Un CUSTOMER solo puede crear usuarios para sus propios customer_id; si no le pertenecen, la respuesta es 401 (Unauthorized).
  • Si el email ya existe, la respuesta es 422 o 400 con el mensaje User <email> already exists.
ℹ️

En el primer intento de inicio de sesión del usuario creado, el response indicará que es necesario hacer un cambio de contraseña. Para cumplir con este requisito, se debe enviar una solicitud de Cambio de contraseña.

⚠️

Si el cliente no tiene habilitada la notificación de usuarios por email, la respuesta incluye la contraseña temporal generada en password y en attributes.verification_code. Si la tiene habilitada, ambos campos se omiten.

curl --location --request POST 'https://api.menta.global/api/v1/users' \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json' \
--data-raw '{
"user_type": "string",
"password": "string",
"attributes": {
  "name":"string",
  "email": "string",
  "customer_id": "array",
  "merchant_id": "array"
}
}'
{
"attributes": {
    "id": "string",
    "name": "string",
    "username": "string",
    "description": "string",
    "email": "string",
    "merchant_id": "array",
    "customer_id": "array",
    "country": "string",
    "type": "string",
    "scope": "string"
},
"status": "CONFIRMED",
"enabled": boolean,
"permanent": false,
"audit": {
    "creation_date": "2019-02-05T21:03:54.499+0000",
    "update_date": "2019-02-05T21:03:54.499+0000"
}
}

username y description se incluyen solo si se enviaron.

Borrar usuarioRestaurar contraseña