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

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

Пригласить участника

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, доступ будет на уровне всего мерчанта.

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

Получатель входит в аккаунт и принимает приглашение через POST /api/v1/invites/{id}/accept. Этому запросу тоже нужен ключ идемпотентности.

По умолчанию у мерчанта может быть до 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}	отозвать существующий доступ.

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

Заблокированные аккаунты

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

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

Выгрузить историю

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