Eine Organisation umfasst Team und Abrechnung, eine Anwendung enthält Workflows und API-Schlüssel und ist Live oder Sandbox. Das vermeidet viele Überraschungen.

Kurze Antwort

Organisation = Ihr Team, Ihr Abrechnungsguthaben, Ihr Audit-Protokoll. Anwendung = Workflows, API-Schlüssel, Webhook-Endpunkte, Aufbewahrungsrichtlinie und Produkte, in zwei Umgebungen: Live und Sandbox. Die meisten Probleme der Art "meine Änderung hatte keine Wirkung" beruhen darauf, in der falschen Anwendung oder der falschen Umgebung zu sein.

#Die beiden Ebenen

Organisation ist Ihr Konto. Sie umfasst:

  • Ihr Team und dessen Rollen
  • Ihr Abrechnungsguthaben und Ihre Rechnungen
  • Ihr Audit-Protokoll
  • Alle Ihre Anwendungen

Anwendung ist ein Arbeitsbereich innerhalb der Organisation. Sie umfasst:

  • Eigene Workflows
  • Eigene API-Schlüssel
  • Eigene Webhook-Endpunkte
  • Eine eigene Datenaufbewahrungsrichtlinie
  • Eigene Produkte, wo das Aktivieren von Produkten pro Anwendung bereits eingeführt ist. Siehe Produkte und was sie enthalten
  • Zwei Umgebungen: Live und Sandbox

Wechseln Sie die Anwendung über die Anwendungskarte oben in der Seitenleiste. Der Wechsel gilt sofort. Über dasselbe Menü öffnen Sie Anwendungseinstellungen und Anwendung erstellen.

#Warum das wichtiger ist, als es aussieht

Fast jede Meldung der Art "ich habe es geändert und nichts ist passiert" lässt sich auf diese Struktur zurückführen:

  • Sie haben einen Workflow in Anwendung A bearbeitet, während Ihre Sessions unter Anwendung B laufen.
  • Sie haben einen Webhook-Endpunkt zu einer Anwendung hinzugefügt und Ereignisse von einer anderen erwartet.
  • Sie sehen sich Sandbox an, während Ihr Traffic in Live läuft, oder umgekehrt.
  • Sie rufen mit einem Schlüssel einer anderen Anwendung auf als der, zu der die angesprochene Ressource gehört, und erhalten einen 404 oder 403 für etwas, das eindeutig existiert.

Bevor Sie irgendetwas anderes debuggen, bestätigen Sie die Anwendung. Siehe API-Fehler und was sie bedeuten.

#Live und Sandbox sind getrennte Umgebungen

Neue Anwendungen sind Live. Getestet wird in Sandbox: der gemeinsamen Testanwendung Ihrer Organisation, mit eigenen Daten und eigenen Schlüsseln. Wechseln Sie zwischen beiden mit dem Umschalter Live und Sandbox unter dem Anwendungsnamen in der Seitenleiste.

Verifizierungen, API-Schlüssel, Webhooks und Listen sind in jeder Umgebung getrennt. Das Branding wird gemeinsam genutzt, und Workflows werden einmal erstellt und können zwischen den Umgebungen kopiert werden. Genau das ist der Sinn dieser Trennung: Testverkehr und Produktivdaten vermischen sich nie, und ein Sandbox-Schlüssel kann nicht versehentlich echte Credits ausgeben. Siehe Testen in der Sandbox.

Tipp

Benennen Sie die Anwendungen so, dass Sie sie auf einen Blick nie verwechseln können - acme-onboarding und acme-payments sind besser als "Application" und "Application (2)". Speichern Sie die Schlüssel in Ihrem Secret-Manager unter Namen, die die Umgebung enthalten, und lassen Sie niemals eine einzelne Umgebungsvariable "welcher Schlüssel gerade aktuell ist" enthalten.

#Wie viele Anwendungen sollten Sie haben?

Die meisten Teams beginnen mit einer, die Ihnen bereits Live und Sandbox bietet. Darüber hinaus teilen Sie nach allem auf, was eine eigene Konfiguration oder eigene Isolation benötigt:

  • Pro Produkt, wenn verschiedene Produkte unterschiedliche Workflows und unterschiedliche Webhook-Endpunkte benötigen.
  • Pro Pre-Production-Umgebung, wenn Sie mehr als die eine Sandbox benötigen.
  • Pro Marke, wenn Sie Verifizierung unter mehreren Marken mit unterschiedlichem Styling anbieten.
  • Pro Aufbewahrungsrichtlinie, da die Aufbewahrung pro Anwendung konfiguriert wird.

Was sich nicht pro Anwendung aufteilt: Ihr Guthaben, das auf Organisationsebene liegt. Jede Anwendung greift auf dieselben Credits zu.

#Weitere Anwendungen erstellen

Öffnen Sie die Anwendungskarte oben in der Seitenleiste, wählen Sie Anwendung erstellen und geben Sie dann einen Anwendungsnamen ein (wo Produkte pro Anwendung bereits eingeführt sind, wählen Sie außerdem, wofür sie gedacht ist). Wenn die Option fehlt, oder Sie eine Anwendung über die API statt über die Konsole erstellen müssen, ist das eine Frage der Berechtigung auf Kontoebene, die es sich lohnt, beim Support zu erfragen, statt sie zu umgehen.

#Mehrere Organisationen

Eine Person kann mehreren Organisationen angehören und wechselt zwischen ihnen über das Organisationsmenü oben in der Seitenleiste, in dem auch ausstehende Einladungen erscheinen. Selbst mehr als eine Organisation zu erstellen ist Reseller-Konten vorbehalten (kontaktieren Sie den Support, um es freizuschalten), und es gibt keine Möglichkeit, Unterorganisationen oder Unterkonten unter Ihrer anzulegen. Wenn Sie mehrere eigene Kunden bedienen, ist die unterstützte Struktur eine Anwendung pro Kunde innerhalb Ihrer einzigen Organisation: Jede Anwendung hat ihre eigenen Workflows, ihr Branding, ihre API-Schlüssel, Ergebnisse und Nutzungsberichte, vollständig von den anderen getrennt, während die Abrechnung auf Organisationsebene bleibt.

#Didit weiterverkaufen

Wenn Sie Didit in Ihr eigenes Produkt bündeln und Ihren Kunden berechnen möchten, ist das das Reseller-Modell. So funktioniert es, in den Worten, die der Support jedem gibt, der fragt:

  • Vorausbezahltes Guthaben. Ein Mindesterstkauf von 5.000 USD, vorausbezahlt, mit einer einjährigen Vereinbarung. Das Guthaben verfällt nie, liegt auf Organisationsebene und wird über alle Endkunden verbraucht, die Sie anbinden, und es enthält einen Mengenrabatt, der mit dem Betrag steigt.
  • Das Dashboard bauen Sie. Sie integrieren die Didit-API in Ihr eigenes Frontend, und Ihre Kunden verwalten dort ihre Workflows, ihr Branding und ihre Rollen. Didit stellt keine White-Label-Kopie der Business Console bereit; die Verifizierungsbildschirme, die Ihre Endnutzer sehen, können Ihre Marke tragen (siehe White Label), die Konsole nicht.
  • Ihre Marge gehört Ihnen. Sie legen den Preis fest, den Ihre Kunden zahlen. Didit berechnet Ihnen pro abgeschlossener Funktion zu den für die Laufzeit festgelegten Stückpreisen.
  • Kein Programm für lokale Partner. Didit führt Demos, Onboarding und Support direkt mit den Kunden durch und sucht keine Vertriebs- oder Implementierungspartner.

Wenn Sie den Weiterverkauf lieber nicht übernehmen möchten, nutzen Sie stattdessen die Empfehlungsoption: Öffnen Sie in der Business Console Einstellungen → Empfehlen und verdienen, holen Sie sich Ihren Link und teilen Sie ihn. Sie erhalten 10 % Provision auf jede Bareinzahlung einer empfohlenen Organisation, 36 Monate lang ab deren erster Einzahlung, als Didit-Guthaben nutzbar oder nach der Reifefrist per Banküberweisung auszahlbar - ohne Liefer- oder Supportpflichten. Sie können Ihre Integration im Free-Plan bauen und testen, bevor Sie sich für eines von beiden entscheiden.

#Eine Anwendung löschen

Das dauerhafte Löschen einer Anwendung ist noch nicht verfügbar: Die Anwendungseinstellungen haben eine Gefahrenzone, die jedoch angibt, dass das Löschen nicht verfügbar ist, und nichts löscht. Ihre Optionen bis dahin:

  • Nicht mehr verwenden. Benennen Sie sie um (etwa acme-old), damit niemand sie versehentlich auswählt, und widerrufen Sie ihre API-Schlüssel unter Entwickler → API-Schlüssel.
  • Ihre Kundendaten löschen. Verifizierungsdaten folgen der Aufbewahrungsrichtlinie und den Löschregeln für diese Daten, nicht dem Lebenszyklus der Anwendung - löschen Sie die Daten explizit. Siehe Sessions und personenbezogene Daten löschen.
  • Neu anfangen. Der Support kann die gesamte Organisation löschen, damit Sie eine neue erstellen können - ein letzter Ausweg, da Team, Guthaben und Verlauf mit ihr verschwinden.

#Alles ist zuordenbar

Jede Änderung zeichnet im Audit-Protokoll auf, zu welcher Anwendung sie gehörte. Das macht eine Struktur mit mehreren Anwendungen überprüfbar statt nur ordentlich. Siehe Audit-Protokolle nutzen.

Kommen Sie nicht weiter? Sprechen Sie mit einem Menschen.

Geben Sie Ihre Organisations-ID und die Session-ID an, um die es geht.

Support kontaktieren