Zum Inhalt springen

Team und Zugriff

Laden Sie jemanden zum gesamten Händlerkonto oder zu einem einzelnen Shop ein. Verwenden Sie eine Anmeldesitzung mit Händlerinhaber-Zugriff; ein Shop-API-Schlüssel kann das Team nicht verwalten. Um Ihr gesamtes Invoise-Konto samt Wallet und Karte zu teilen, fügen Sie stattdessen ein Kontomitglied hinzu.

Terminal-Fenster
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>"}'

Verwenden Sie viewer zum Lesen, developer für Integrationsarbeit oder owner für die Verwaltung. Legen Sie shop_id fest, um die Einladung auf einen Shop zu beschränken. Wird es weggelassen oder auf null gesetzt, wird Zugriff auf den gesamten Händler gewährt.

Um einen Agenten oder jemanden einzuladen, der sich mit einer Wallet anmeldet, senden Sie "provider":"wallet" mit dessen EVM-Adresse als subject. Die Person nimmt an, nachdem sie sich mit dieser Wallet angemeldet hat.

Prüfen Sie Rolle und Bereich vor dem Senden. Der ausgewählte Shop muss aktiv sein und zu diesem Händler gehören; ein ungültiger Shop fällt nicht auf händlerweiten Zugriff zurück.

Der Empfänger meldet sich an und nimmt mit POST /api/v1/invites/{id}/accept an. Senden Sie auch für diese Anfrage einen Idempotenzschlüssel. Vor dem Annehmen zeigt GET /api/v1/invites/{id} Händler, Shop, Rolle und Einladenden, mit status open, accepted, used, revoked, expired oder unavailable. Eine Einladung bleibt standardmäßig 7 Tage offen.

Standardmäßig kann ein Händler bis zu 10 Mitglieder und ausstehende Einladungen zusammen haben. Darüber hinaus geben sowohl das Einladen als auch das Annehmen 400 team_limit_reached zurück; das Invoise-Team kann das Limit erhöhen. Siehe Limits.

Anfrage Zweck
GET /api/v1/merchants/{merchant_id}/team listet Berechtigungen und Einladungen auf.
DELETE /api/v1/merchants/{merchant_id}/invites/{id} widerruft eine ausstehende Einladung.
DELETE /api/v1/merchants/{merchant_id}/grants/{id} entfernt bestehenden Zugriff.
POST /api/v1/merchants/{merchant_id}/leave einen Händler verlassen, dem Sie beigetreten sind.

Änderungen erfordern die passende Inhaber-Sitzung und einen Idempotenzschlüssel. Wenn MFA aktiviert ist, kann ein sensibler Vorgang einen frischen Code erfordern.

Zum Verlassen genügt Ihre eigene Sitzung. Abgelehnt wird es für den selbst angelegten Händler (own_merchant), für seinen letzten Inhaber (last_merchant_owner) und solange einer seiner Shops an Ihre Invoise-Wallet auszahlt (wallet_in_use, mit den Shop-Namen in error.details).

Ein Kontomitglied arbeitet in Ihrem gesamten Invoise-Konto: in der Wallet, der Karte, den Empfehlungen und allen Händlern, die Ihnen gehören. Ein Teammitglied aus den Abschnitten oben erhält eine Rolle in einem Händler oder einem Shop und sieht Ihre Wallet und Karte nie. Kontomitglieder verwalten Sie im Dashboard unter Profil → Zugriff.

Rolle Darf
Betrachter (viewer) Wallet, Karte, Empfehlungen und Ihre Händler sehen. Ändert nichts.
Bearbeiter (editor) Was ein Betrachter darf, und in den Shops als developer arbeiten: Rechnungen, Adressen, API-Schlüssel, Webhooks. Shop-Einstellungen bleiben beim Inhaber.
Inhaber (owner) Alles, was Sie dürfen: auszahlen, Wallet-Schutz und automatische Auszahlungen ändern, die Karte, Shop-Einstellungen und die Mitglieder des Kontos.

Ein Betrachter oder Bearbeiter zahlt nie aus, signiert nichts, ändert nie den Wallet-Schutz, stellt keine Karte aus, schließt keine und verwaltet keine Mitglieder. Ein Mitinhaber braucht zum Signieren weiterhin Code, Passwort oder Wiederherstellungsschlüssel der Wallet, aber geben Sie diese Rolle nur jemandem, dem Sie wie sich selbst vertrauen. Hat Ihr Konto 2FA, bestätigt ein Mitglied sensible Änderungen mit einem eigenen zweiten Faktor und braucht daher ebenfalls 2FA (403 account_mfa_required).

Drücken Sie in Profil → Zugriff auf Einladen, geben Sie eine E-Mail-Adresse ein und wählen Sie eine Rolle. Die Einladung gilt 7 Tage; eine erneute Einladung derselben E-Mail-Adresse verlängert sie und ändert ihre Rolle. Ein Konto kann bis zu 20 Mitglieder und Einladungen zusammen haben.

Annehmen kann nur ein Benutzer, der diese E-Mail-Adresse nachgewiesen hat: durch Anmeldung mit einem an sie gesendeten Code oder mit einem Google-Konto, dessen E-Mail-Adresse Google bestätigt hat. Eine bei der Registrierung mit einer Wallet eingegebene E-Mail-Adresse zählt erst nach der ersten Anmeldung mit einem an sie gesendeten Code. Die eingeladene Person findet die Einladung in den Benachrichtigungen und unter Profil → Zugriff → Einladungen und drückt Annehmen oder Ablehnen; wer kein Invoise-Konto hat, erhält sie per E-Mail. Ein Mitglied braucht keinen eigenen Händler.

Mit Ihnen geteilte Konten finden Sie im Kontomenü unter Konten, und Mein Konto bringt Sie zurück. Jede Seite eines fremden Kontos zeigt eine Leiste mit dem Konto, Ihrer Rolle und Zurück zu meinem Konto. Profil → Zugriff → Mit Ihnen geteilt listet sie ebenfalls auf, mit Öffnen und einer Schaltfläche zum Verlassen des Kontos. Wird das Konto des Inhabers gesperrt oder gelöscht, verlieren seine Mitglieder den Zugriff.

Der Inhaber ändert die Rolle eines Mitglieds oder drückt Zugriff entfernen, bei einer ausstehenden Einladung Einladung widerrufen. Verlässt ein Mitglied das Konto oder wird es entfernt, werden die API-Schlüssel widerrufen, die es in Ihren Shops erstellt hat; dasselbe geschieht, wenn seine Rolle zu Betrachter wird. Zu jeder Änderung erhalten Sie einen Sicherheitshinweis: Prüfen Sie, was das Mitglied eingerichtet haben könnte, etwa Webhooks, Teammitglieder, den Delegierten und automatische Auszahlungen.

Das Dashboard ruft diese Anfragen mit Ihrer Sitzung auf; ein Shop-API-Schlüssel kann sie nicht verwenden.

Anfrage Zweck
GET /api/v1/account/members listet Mitglieder und Einladungen auf, mit status pending, active oder expired.
POST /api/v1/account/members einladen: {"email":"[email protected]","role":"viewer"}.
PATCH /api/v1/account/members/{id} die Rolle ändern: {"role":"editor"}.
DELETE /api/v1/account/members/{id} eine Einladung widerrufen oder ein Mitglied entfernen.
GET /api/v1/accounts Konten, in denen Sie Mitglied sind, und Einladungen an Sie.
POST /api/v1/accounts/invites/{id}/accept eine Einladung annehmen.
DELETE /api/v1/accounts/invites/{id} eine Einladung ablehnen.
DELETE /api/v1/accounts/{owner_id} ein Konto verlassen.

Um in einem fremden Konto zu handeln, senden Sie X-Invoise-Account: <owner_id>, die id aus GET /api/v1/accounts; damit verwaltet ein Mitinhaber auch die Mitglieder dieses Kontos. Der Ereignisstrom GET /api/v1/live und export.csv-Downloads, die keinen Header tragen können, nehmen stattdessen ?account=<owner_id>. Ihr eigenes Profil, die Anmeldung, Benachrichtigungen und Mitgliedschaften ignorieren ihn. Eine Anfrage außerhalb Ihrer Rolle gibt 403 mit account_access_denied, account_read_only oder account_owner_only zurück. Einladungsfehler geben 400 zurück: invalid_email, invalid_role, account_invite_self, account_member_exists, account_member_limit, account_member_not_found, invite_unavailable.

Wenn das Invoise-Team einen Händler sperrt, werden dessen unbezahlte Rechnungen mit dem Grund merchant_blocked storniert, seine Einzahlungsadressen deaktiviert und seine API-Schlüssel funktionieren nicht mehr. Mitglieder sehen den Grund im Dashboard.

Ein gesperrter Benutzer kann sich weiterhin anmelden, seine Wallet, Karte und Benachrichtigungen lesen, aus der Wallet auszahlen und seine Karte schließen. Andere Anfragen geben 403 account_disabled mit dem Grund in error.details zurück.

Invoise sendet Hinweise zu Konto, Zahlungen und Sicherheit, etwa zu eingehenden Zahlungen, Wallet-Auszahlungen, Sicherheitsänderungen, Kartenvorgängen und Einladungen, per E-Mail und, sobald Sie es verbinden, über Telegram. Die Kanäle wählen Sie in Ihrem Profil.

Laden Sie GET /api/v1/shops/{shop_id}/export.csv mit Shop-Lesezugriff herunter. Verwenden Sie es für Buchhaltungsexporte, nicht als Zahlungsbenachrichtigung.