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

Запросіть когось до всього облікового запису мерчанта або до одного магазину. Використовуйте сесію входу з доступом власника мерчанта; 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, доступ надається в межах усього мерчанта.

Перевірте роль і область перед надсиланням. Обраний магазин має бути активним і належати цьому мерчанту; недійсний магазин не переходить у доступ в межах усього мерчанта.

Отримувач входить і приймає запрошення через 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 з доступом на читання магазину. Використовуйте це для бухгалтерських експортів, а не як сповіщення про платіж.