Перейти к содержимому

Команда и доступы

Участника можно пригласить во весь аккаунт мерчанта или только в один магазин. Для управления командой нужна сессия владельца мерчанта; API-ключ магазина не подходит. Чтобы открыть весь аккаунт Invoise вместе с кошельком и картой, добавьте участника аккаунта.

Окно терминала
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>"}'

Роль viewer нужна для чтения, developer — для интеграции, owner — для управления. shop_id ограничивает приглашение одним магазином. Если не передать поле или указать null, доступ будет на уровне всего мерчанта.

Чтобы пригласить агента или того, кто входит по кошельку, передайте "provider":"wallet" и его EVM-адрес в subject. Он примет приглашение после входа этим кошельком.

Проверьте роль и область доступа перед отправкой. Магазин должен быть активным и принадлежать этому мерчанту. Ошибка в ID не выдаст доступ ко всем магазинам.

Получатель входит в аккаунт и принимает приглашение через POST /api/v1/invites/{id}/accept. Этому запросу тоже нужен ключ идемпотентности. До принятия GET /api/v1/invites/{id} показывает мерчанта, магазин, роль и того, кто пригласил, а status — open, accepted, used, revoked, expired или unavailable. По умолчанию приглашение действует 7 дней.

По умолчанию у мерчанта может быть до 10 участников и ожидающих приглашений вместе. Сверх этого и приглашение, и его принятие вернут 400 team_limit_reached; сотрудники Invoise могут поднять лимит. См. Лимиты.

Запрос Назначение
GET /api/v1/merchants/{merchant_id}/team список выданных доступов и приглашений.
DELETE /api/v1/merchants/{merchant_id}/invites/{id} отозвать приглашение.
DELETE /api/v1/merchants/{merchant_id}/grants/{id} отозвать существующий доступ.
POST /api/v1/merchants/{merchant_id}/leave выйти из мерчанта, к которому вы присоединились.

Изменения требуют прав владельца и ключа идемпотентности. Если включено MFA, чувствительное действие может попросить свежий код.

Для выхода нужна только ваша сессия. Выйти нельзя из мерчанта, который вы создали (own_merchant), его последнему владельцу (last_merchant_owner) и пока какой-то его магазин платит на ваш кошелёк Invoise (wallet_in_use, названия магазинов — в error.details).

Участник аккаунта работает во всём вашем аккаунте Invoise: в кошельке, карте, рефералах и всех мерчантах, которыми вы владеете. Участник команды из разделов выше получает роль в одном мерчанте или магазине и не видит ваш кошелёк и карту. Участниками аккаунта управляют в кабинете: Профиль → Доступ.

Роль Может
Просмотр (viewer) Видеть кошелёк, карту, рефералов и ваших мерчантов. Ничего не меняет.
Редактор (editor) То же, что просмотр, и работать в магазинах как developer: инвойсы, адреса, API-ключи, вебхуки. Настройки магазинов остаются за владельцем.
Владелец (owner) Всё, что можете вы: выводить деньги, менять защиту кошелька и автовывод, карту, настройки магазинов и участников аккаунта.

Просмотр и редактор никогда не выводят деньги, не подписывают транзакции, не меняют защиту кошелька, не выпускают и не закрывают карту и не управляют участниками. Совладельцу для подписи всё равно нужны код, пароль или ключ восстановления кошелька, но давайте эту роль только тому, кому доверяете как себе. Если в вашем аккаунте включена 2FA, участник подтверждает чувствительные изменения своим вторым фактором, поэтому 2FA нужна и ему (403 account_mfa_required).

В Профиль → Доступ нажмите Пригласить, укажите email и выберите роль. Приглашение действует 7 дней; повторное приглашение на тот же email продлевает его и меняет роль. В аккаунте может быть до 20 участников и приглашений вместе.

Принять приглашение может только пользователь, подтвердивший этот email: входом по коду, отправленному на него, или через аккаунт Google, email которого подтвердил Google. Email, введённый при регистрации через кошелёк, считается подтверждённым только после первого входа по коду на этот адрес. Приглашённый видит приглашение в уведомлениях и в Профиль → Доступ → Приглашения и нажимает Принять или Отклонить; тот, у кого нет аккаунта Invoise, получает его письмом. Своего мерчанта участнику не нужно.

Аккаунты, к которым вам дали доступ, есть в меню аккаунта в разделе Аккаунты; Мой аккаунт возвращает в свой. На каждой странице чужого аккаунта видна плашка с аккаунтом и вашей ролью и кнопкой Вернуться в свой аккаунт. В Профиль → Доступ → Чужие аккаунты они тоже перечислены, с кнопками Открыть и Выйти из аккаунта. Если аккаунт владельца заблокирован или удалён, участники теряют к нему доступ.

Владелец меняет роль участника или нажимает Убрать доступ, а для ожидающего приглашения — Отозвать приглашение. Когда участник выходит или его убирают, API-ключи, которые он создал в ваших магазинах, отзываются; то же происходит, когда его роль становится «Просмотр». О каждом изменении приходит уведомление о безопасности: проверьте, что участник мог настроить, — вебхуки, участников команды, делегата и автовывод.

Кабинет вызывает эти запросы с вашей сессией; API-ключ магазина для них не подходит.

Запрос Назначение
GET /api/v1/account/members список участников и приглашений, status — pending, active или expired.
POST /api/v1/account/members пригласить: {"email":"[email protected]","role":"viewer"}.
PATCH /api/v1/account/members/{id} сменить роль: {"role":"editor"}.
DELETE /api/v1/account/members/{id} отозвать приглашение или убрать участника.
GET /api/v1/accounts аккаунты, где вы участник, и приглашения вам.
POST /api/v1/accounts/invites/{id}/accept принять приглашение.
DELETE /api/v1/accounts/invites/{id} отклонить приглашение.
DELETE /api/v1/accounts/{owner_id} выйти из аккаунта.

Чтобы действовать в чужом аккаунте, передайте X-Invoise-Account: <owner_id> — id из GET /api/v1/accounts; с ним совладелец управляет и участниками этого аккаунта. Поток событий GET /api/v1/live и выгрузки export.csv, которые не могут нести заголовок, принимают вместо него ?account=<owner_id>. Ваши профиль, вход, уведомления и участие в аккаунтах заголовок не учитывают. Запрос вне вашей роли возвращает 403 с account_access_denied, account_read_only или account_owner_only. Ошибки приглашений возвращают 400: invalid_email, invalid_role, account_invite_self, account_member_exists, account_member_limit, account_member_not_found, invite_unavailable.

Если сотрудники Invoise блокируют мерчанта, его неоплаченные инвойсы отменяются с причиной merchant_blocked, депозитные адреса отключаются, а API-ключи перестают работать. Участники видят причину в интерфейсе.

Заблокированный пользователь по-прежнему может войти, посмотреть кошелёк, карту и уведомления, вывести деньги из кошелька и закрыть карту. Остальные запросы возвращают 403 account_disabled; причина — в error.details.

Invoise присылает уведомления об аккаунте, платежах и безопасности — о поступлениях, выводах из кошелька, изменениях защиты, операциях с картой и приглашениях — по email и, если вы его подключили, в Telegram. Каналы выбираются в профиле.

GET /api/v1/shops/{shop_id}/export.csv возвращает CSV для бухгалтерии. Нужен доступ на чтение магазина. Для уведомления об оплате используйте статус или вебхуки.