Skip to main content
POST
/
api
/
v1
/
merchants
/
{id}
/
invitations
Invitar miembro
curl --request POST \
  --url https://api.venepagos.com.ve/api/v1/merchants/{id}/invitations \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "<string>",
  "role": "<string>"
}
'
{
  "id": "inv_def456",
  "merchantId": "mrc_abc123",
  "email": "nuevo@example.com",
  "role": "MEMBER",
  "token": "tok_invitation_abc123def456",
  "status": "PENDING",
  "expiresAt": "2026-04-07T12:00:00.000Z"
}

​
Autenticación

Este endpoint requiere autenticación mediante Bearer token.

​
Parámetros de ruta

​
id
string
required
Identificador único del merchant.

​
Cuerpo de la solicitud

​
email
string
required
Correo electrónico del usuario a invitar.
​
role
string
required
Rol que tendrá el usuario invitado. Valores posibles: ADMIN, MEMBER.

​
Respuesta

​
id
string
Identificador único de la invitación.
​
merchantId
string
ID del merchant al que se invita.
​
email
string
Correo electrónico del usuario invitado.
​
role
string
Rol asignado al invitado.
​
token
string
Token único de la invitación. El usuario invitado debe usar este token para aceptar la invitación.
​
status
string
Estado de la invitación (PENDING, ACCEPTED, EXPIRED).
​
expiresAt
string
Fecha de expiración de la invitación en formato ISO 8601.
{
  "id": "inv_def456",
  "merchantId": "mrc_abc123",
  "email": "nuevo@example.com",
  "role": "MEMBER",
  "token": "tok_invitation_abc123def456",
  "status": "PENDING",
  "expiresAt": "2026-04-07T12:00:00.000Z"
}