Zum Hauptinhalt springen

Zahlungen

Diese Seite erklärt, wie Zahlungen in Agon entstehen, wie du dein eigenes Stripe-Konto für Online-Kartenzahlungen verbindest und wo du Zahlungssummen einsehen kannst.

Zahlungen ist kein eigener Menüpunkt in der linken Seitenleiste. Zahlungsbezogene Einstellungen findest du unter Einstellungen → Abrechnung, Zahlungssummen unter Berichte → Umsatz.


Wie Zahlungen in Agon funktionieren​

Agon verarbeitet Zahlungen nicht selbst und hat keinen Bildschirm, um eine Zahlung manuell zu erfassen, und keinen Rückerstattungs-Button. Ein Payment-Datensatz entsteht automatisch auf zwei Wegen:

  • Stripe-Checkout — sobald du dein eigenes Stripe-Konto verbunden hast (siehe unten), kann ein Kunde online eine Mitgliedschaft oder eine selbst gekaufte Geschenkkarte über die mobile App bezahlen. Das Geld fließt direkt zwischen deinem Kunden und deinem eigenen Bankkonto; Agon hält niemals Gelder.
  • Eine Gebühr für späte Stornierung oder Nichterscheinen — wenn sie tatsächlich berechnet wird (siehe Einstellungen — Stornierungsrichtlinie und Mitgliedschaften — abweichende Gebühren), erfasst Agon sie als Payment mit Anbieter system.

Das manuelle Zuweisen einer Mitgliedschaft an einen Kunden (siehe Mitgliedschaften) erzeugt keine Zahlung — es weist nur die Mitgliedschaft zu. Zahlt dir ein Kunde bar oder per Überweisung, gibt es derzeit keine Möglichkeit, diese Zahlung in Agon zu erfassen: Du weist einfach die Mitgliedschaft zu, genau wie bei einer kostenlosen Testphase.

Verkäufe von Einzelhandelsprodukten werden separat erfasst (siehe POS / Einzelhandel) als eigener Datensatztyp, nicht als Payment-Zeilen — sie erscheinen im separaten Produktverkaufsbericht, nicht im Umsatz.


Stripe verbinden​

Agon bietet zwei Wege, dein eigenes Stripe-Konto zu verbinden. Für die meisten Studiobetreiber ist Connect with Stripe die einfachere Wahl, da du nie selbst einen API-Schlüssel suchen oder einfügen musst. Wenn du bereits Stripe-API-Schlüssel hast oder den OAuth-Ablauf nicht nutzen möchtest, kannst du sie stattdessen manuell eingeben — beide Wege werden vollständig unterstützt.

Option A: Connect with Stripe (empfohlen)​

  1. Gehe zu Einstellungen → Abrechnung.
  2. Klicke auf Connect with Stripe.
  3. Dein Browser öffnet Stripes eigene gehostete Autorisierungsseite. Melde dich bei deinem bestehenden Stripe-Konto an, oder erstelle eines, und autorisiere Agon.
  4. Stripe leitet dich zu einer kurzen, von Agon gehosteten Bestätigungsseite weiter. Schließe diesen Tab und kehre zu Agon zurück.
  5. Der Status Stripe-Verbindung in Einstellungen → Abrechnung wechselt zu Verbunden — entweder automatisch, sobald du zum Agon-Fenster zurückwechselst, oder nach Klick auf Status aktualisieren.

Dies verbindet direkt dein eigenes Stripe-Konto — Agon hält niemals deine Gelder, und es gibt kein gemeinsames Plattformkonto zwischen dir und Stripe.

Option B: Stripe-API-Schlüssel manuell eingeben​

Nutze diesen Weg, wenn du bereits Stripe-API-Schlüssel zur Hand hast oder den OAuth-Ablauf oben nicht nutzen möchtest.

  1. Gehe zu Einstellungen → Abrechnung und öffne Erweiterte Optionen.
  2. Gib deinen Geheimschlüssel und deinen Öffentlichen Schlüssel ein, aus deinem eigenen Stripe-Dashboard (Developers → API keys).
  3. Klicke auf Speichern.

Der Status Stripe-Verbindung wechselt zu Verbunden, sobald gültige Schlüssel gespeichert sind.

Den Webhook einrichten​

Das Feld Webhook-Geheimnis ist in Einstellungen → Abrechnung immer sichtbar — es ist niemals in den Erweiterten Optionen versteckt —, weil Agon es braucht, um zuverlässig zu erfahren, wenn eine Zahlung erfolgreich ist, ein Abonnement verlängert wird, eine Zahlung fehlschlägt oder gekündigt wird.

  • Wenn du dich mit Option B (manuelle Schlüssel) verbunden hast, registriert Agon den Webhook automatisch für dich. Es gibt nichts weiter zu tun.
  • Wenn du dich mit Option A (Connect with Stripe) verbunden hast, verhindern Stripes eigene Einschränkungen meist, dass Agon den Webhook automatisch registriert — das ist eine Grenze der Stripe-Plattform, kein Versäumnis von Agon. Agon zeigt dir die genaue Webhook-URL zum Registrieren, und du musst den Webhook einmalig selbst in deinem eigenen Stripe-Dashboard anlegen — die genauen Schritte findest du unter Stripe-Webhook einrichten.

Wenn dein Studio einen aktiven wiederkehrenden (Abo-)Mitgliedschaftstyp hat, aber kein Webhook-Geheimnis gespeichert ist, zeigt Agon eine Warnung in Einstellungen → Abrechnung, da wiederkehrende Abrechnungen sonst keine Möglichkeit haben, Verlängerungen, Fehlschläge oder Kündigungen zu erkennen.

Stripe-Schlüssel ändern oder entfernen​

Es gibt keine separate Aktion „Stripe trennen“. Um Stripe-Zahlungen zu beenden, widerrufe oder erneuere den Schlüssel direkt in deinem Stripe-Dashboard — Kundenzahlungen schlagen dann fehl, bis du einen neuen funktionierenden Schlüssel unter Einstellungen → Abrechnung speicherst, oder ersetze die Schlüssel, die du nicht mehr verwenden willst.


Eine Rückerstattung ausstellen​

Agon hat keinen eigenen Rückerstattungs-Button:

  • Stripe-Zahlung — bearbeite die Rückerstattung in deinem Stripe-Dashboard. Agon erhält das Ergebnis beim nächsten Webhook, der den Zahlungsstatus hier aktualisiert.
  • Bargeld oder Überweisung — gib das Geld selbst zurück; in Agon gibt es in beiden Fällen nichts zu aktualisieren, da diese Zahlung hier nie erfasst wurde.

Zahlungsstatus​

StatusENITFRDEESPTNL
CompletedCompletedCompletatoComplétéAbgeschlossenCompletadoConcluídoVoltooid
RefundedRefundedRimborsatoRembourséErstattetReembolsadoReembolsadoTerugbetaald
FailedFailedFallitoÉchouéFehlgeschlagenFallidoFalhouMislukt

Zahlungssummen ansehen​

Gehe zu Berichte → Umsatz für den Gesamtumsatz, die Anzahl der Zahlungen und den durchschnittlichen Zahlungsbetrag über einen Datumsbereich. Es gibt derzeit keinen Bildschirm, der den Zahlungsverlauf eines einzelnen Kunden auflistet. Manuell zugewiesene, bar bezahlte Mitgliedschaften erscheinen ebenfalls nicht im Umsatz, da sie nie einen Payment-Datensatz erzeugen (siehe oben).


Was tun, wenn etwas schiefgeht?​

Eine Stripe-Zahlung wird als Ausstehend angezeigt Warte ein paar Minuten — Stripe-Webhooks können sich verzögern. Ist sie nach 10 Minuten immer noch ausstehend, prüfe dein Stripe-Dashboard und ob das Webhook-Geheimnis unter Einstellungen → Abrechnung mit dem in Stripe angezeigten übereinstimmt.

Die Stripe-Verbindung wird als Nicht verbunden angezeigt Gehe zu Einstellungen → Abrechnung und klicke erneut auf Connect with Stripe, oder gib, falls du den manuellen Weg nutzt, deinen Geheimschlüssel und deinen Öffentlichen Schlüssel in den Erweiterten Optionen erneut ein.

Meine Umsatzzahlen wirken niedriger als das, was ich tatsächlich eingenommen habe Prüfe, ob manche Mitgliedschaften manuell zugewiesen statt über Stripe-Checkout bezahlt wurden — diese erzeugen nie einen Payment-Datensatz und zählen deshalb nicht zum Umsatz.

Verwandte Seiten​