Ir al contenido

Equipo y acceso

Invita a alguien a toda la cuenta del comercio o a una sola tienda. Usa una sesión de inicio de sesión con acceso de propietario del comercio; una clave de API de tienda no puede gestionar el equipo. Para compartir toda tu cuenta de Invoise, con la billetera y la tarjeta, añade en su lugar un miembro de la cuenta.

Ventana de terminal
curl -X POST 'https://platform.invoise.me/api/v1/merchants/{merchant_id}/invites' \
-H 'Authorization: Bearer <session-token>' \
-H 'Idempotency-Key: <saved-unique-key>' \
-H 'Content-Type: application/json' \
-d '{"provider":"email","subject":"[email protected]","role":"developer","shop_id":"<shop-id>"}'

Usa viewer para lectura, developer para trabajo de integración, u owner para administración. Define shop_id para limitar la invitación a una tienda. Omitirlo o definirlo como null concede acceso en todo el comercio.

Para invitar a un agente o a alguien que inicia sesión con una billetera, envía "provider":"wallet" con su dirección EVM como subject. Acepta después de iniciar sesión con esa billetera.

Comprueba el rol y el alcance antes de enviar. La tienda elegida debe estar activa y pertenecer a ese comercio; una tienda no válida no recurre al acceso en todo el comercio.

El destinatario inicia sesión y acepta con POST /api/v1/invites/{id}/accept. Envía también una clave de idempotencia en esta solicitud. Antes de aceptar, GET /api/v1/invites/{id} muestra el comercio, la tienda, el rol y quién invitó, con status open, accepted, used, revoked, expired o unavailable. Una invitación sigue abierta 7 días por defecto.

Por defecto, un comercio puede tener hasta 10 miembros e invitaciones pendientes en total. Más allá de eso, tanto invitar como aceptar devuelven 400 team_limit_reached; el personal de Invoise puede aumentar el límite. Consulta Límites.

Solicitud Propósito
GET /api/v1/merchants/{merchant_id}/team lista los accesos concedidos y las invitaciones.
DELETE /api/v1/merchants/{merchant_id}/invites/{id} revoca una invitación pendiente.
DELETE /api/v1/merchants/{merchant_id}/grants/{id} elimina un acceso existente.
POST /api/v1/merchants/{merchant_id}/leave salir de un comercio al que te uniste.

Los cambios requieren la sesión de propietario adecuada y una clave de idempotencia. Si el MFA está activado, una operación sensible puede pedir un código reciente.

Para salir basta tu propia sesión. Se rechaza para el comercio que creaste (own_merchant), para su último propietario (last_merchant_owner) y mientras una de sus tiendas pague a tu billetera de Invoise (wallet_in_use, con los nombres de las tiendas en error.details).

Un miembro de la cuenta trabaja en toda tu cuenta de Invoise: la billetera, la tarjeta, los referidos y todos los comercios que te pertenecen. Un miembro del equipo de las secciones anteriores recibe un rol en un comercio o en una tienda y nunca ve tu billetera ni tu tarjeta. Los miembros de la cuenta se gestionan en el panel, en Perfil → Acceso.

Rol Puede
Lector (viewer) Ver la billetera, la tarjeta, los referidos y tus comercios. No cambia nada.
Editor (editor) Lo mismo que un lector, y trabajar en las tiendas como developer: facturas, direcciones, claves de API, webhooks. La configuración de las tiendas queda en manos del propietario.
Propietario (owner) Todo lo que puedes hacer tú: retirar, cambiar la protección de la billetera y los retiros automáticos, la tarjeta, la configuración de las tiendas y los miembros de la cuenta.

Un lector o un editor nunca retira, firma, cambia la protección de la billetera, emite o cierra la tarjeta ni gestiona miembros. Un copropietario sigue necesitando el código, la contraseña o la clave de recuperación de la billetera para firmar, pero da este rol solo a alguien en quien confíes como en ti. Si tu cuenta tiene 2FA, un miembro confirma los cambios sensibles con un segundo factor propio, así que también necesita 2FA (403 account_mfa_required).

En Perfil → Acceso pulsa Invitar, escribe un correo y elige un rol. La invitación es válida 7 días; invitar de nuevo al mismo correo la renueva y cambia su rol. Una cuenta puede tener hasta 20 miembros e invitaciones en total.

Solo puede aceptar un usuario que haya demostrado ese correo: iniciando sesión con un código enviado a él o con una cuenta de Google cuyo correo haya verificado Google. Un correo escrito al registrarse con una billetera solo cuenta tras el primer inicio de sesión con un código enviado a él. La persona invitada encuentra la invitación en las notificaciones y en Perfil → Acceso → Invitaciones y pulsa Aceptar o Rechazar; quien no tiene cuenta de Invoise la recibe por correo. Un miembro no necesita un comercio propio.

Las cuentas compartidas contigo están en el menú de la cuenta, en Cuentas, y Mi cuenta te devuelve a la tuya. Cada página de una cuenta ajena muestra una barra con la cuenta, tu rol y Volver a mi cuenta. Perfil → Acceso → Compartidas con usted también las lista, con Abrir y un botón para salir de la cuenta. Si la cuenta del propietario se bloquea o se elimina, sus miembros pierden el acceso.

El propietario cambia el rol de un miembro o pulsa Quitar acceso, o Revocar invitación si la invitación está pendiente. Cuando un miembro sale o lo quitan, se revocan las claves de API que creó en tus tiendas; lo mismo ocurre cuando su rol pasa a Lector. Recibes un aviso de seguridad por cada cambio: revisa lo que el miembro pudo configurar, como webhooks, miembros del equipo, el delegado y los retiros automáticos.

El panel hace estas solicitudes con tu sesión; una clave de API de tienda no puede usarlas.

Solicitud Propósito
GET /api/v1/account/members lista miembros e invitaciones, con status pending, active o expired.
POST /api/v1/account/members invitar: {"email":"[email protected]","role":"viewer"}.
PATCH /api/v1/account/members/{id} cambiar el rol: {"role":"editor"}.
DELETE /api/v1/account/members/{id} revocar una invitación o quitar a un miembro.
GET /api/v1/accounts cuentas de las que eres miembro e invitaciones para ti.
POST /api/v1/accounts/invites/{id}/accept aceptar una invitación.
DELETE /api/v1/accounts/invites/{id} rechazar una invitación.
DELETE /api/v1/accounts/{owner_id} salir de una cuenta.

Para actuar en la cuenta de otra persona, envía X-Invoise-Account: <owner_id>, el id de GET /api/v1/accounts; con él, un copropietario también gestiona los miembros de esa cuenta. El flujo de eventos GET /api/v1/live y las descargas export.csv, que no pueden llevar un encabezado, aceptan en su lugar ?account=<owner_id>. Tu propio perfil, el inicio de sesión, las notificaciones y las membresías lo ignoran. Una solicitud fuera de tu rol devuelve 403 con account_access_denied, account_read_only o account_owner_only. Los errores de invitación devuelven 400: invalid_email, invalid_role, account_invite_self, account_member_exists, account_member_limit, account_member_not_found, invite_unavailable.

Si el personal de Invoise bloquea un comercio, sus facturas sin pagar se cancelan con el motivo merchant_blocked, sus direcciones de depósito se deshabilitan y sus claves de API dejan de funcionar. Los miembros ven el motivo en el panel.

Un usuario bloqueado todavía puede iniciar sesión, consultar su billetera, su tarjeta y sus notificaciones, retirar de la billetera y cerrar su tarjeta. Las demás solicitudes devuelven 403 account_disabled con el motivo en error.details.

Invoise envía avisos de cuenta, pagos y seguridad, como pagos entrantes, retiros de la billetera, cambios de seguridad, operaciones con la tarjeta e invitaciones, por correo y, cuando lo conectas, por Telegram. Elige los canales en tu perfil.

Descarga GET /api/v1/shops/{shop_id}/export.csv con acceso de lectura de la tienda. Úsalo para exportaciones contables, no como notificación de pago.