Marktplatz
Erweiterung v1.0.14

Card payments

Überblick

Verbindet mit Stripe. Ihre Kunden bezahlen eine Rechnung oder jeden Datensatz mit einem Betrag per Karte und auf den anderen Wegen, die Ihr Konto bei Stripe anbietet, auf der Seite von Stripe. Die Zahlung wird in Adminium beim Datensatz erfasst, sobald Stripe meldet, dass sie durchgegangen ist – und nur einmal, ob nun der Webhook oder die eigene Prüfung von Adminium sie zuerst findet. Ihr Betrieb ist der Verkäufer: Er eröffnet sein eigenes Konto bei Stripe und erstellt seinen eigenen Schlüssel, und das Geld geht vom Kunden direkt auf dieses Konto. Adminium hat kein Zahlungskonto, keinen eigenen Schlüssel und kein Geld und wickelt nichts ab; Kunden geben ihre Kartendaten nur auf der Seite von Stripe ein, sodass keine Kartennummer Ihren Server erreicht. Eingerichtet wird es in Studio → Zahlungen, zuerst im Testmodus: ein eingeschränkter Schlüssel und ein Webhook je Modus, dann eine Testzahlung mit der Testkarte von Stripe, die nichts in Ihre Tabellen schreibt. Erstattungen gehen vom Zahlungsbereich eines Datensatzes oder von Aktivität aus, und eine Erstattung im Dashboard von Stripe wird ebenfalls erfasst. Eine angefochtene Zahlung wird markiert und verfolgt, bis der Streitfall endet; beantwortet wird er im Dashboard von Stripe. Es speichert keine Karten, nimmt keine Abonnements an und bettet das Zahlungsformular nicht in Ihre eigene Seite ein, und Zahlungen in BHD, JOD, KWD, OMR, TND und UGX werden online noch nicht angenommen. Es braucht Adminium 0.3.33 oder neuer unter einer öffentlichen https-Adresse.

Woran sie sich anschließt

Diese hier ist an keine einzelne App gebunden. Sie arbeitet in Adminium selbst und in jeder App, die Erweiterungen aufnimmt.

Was die Verbindung ihr erlaubt

Es braucht zwei Dinge aus Ihrem eigenen Konto bei Stripe, einmal für den Test- und einmal für den Live-Modus: einen eingeschränkten Schlüssel (rk_…; ein geheimer Schlüssel wird abgelehnt) und das Signaturgeheimnis des Webhooks. Beides wird je Modus verschlüsselt auf Ihrem Server gespeichert, und kein Teil der Erweiterung erreicht je einen Browser. Der Schlüssel erhält nur die Rechte, die die Einrichtungskarte nennt: eine Zahlung starten und eine nicht mehr benötigte beenden, lesen, wie sie ausging und welcher Betrag eingezogen wurde, Erstattungen geben (bei Stripe erlaubt dieses Recht auch, Belastungen zu ändern), Ereignisse und Streitfälle lesen, die Zahlungsarten, die Sie eingeschaltet haben, und zu welchem Konto der Schlüssel gehört. Zahlungen werden nur zu den Zeilen der Tabellen geschrieben, die Sie unter „Was bezahlt werden kann“ wählen. Seine Serverhälfte darf die zwei Adressen unten aufrufen und sonst nichts.

Adressen, die ihr Servercode erreichen darf

  • api.stripe.com
  • checkout.stripe.com

Diese Liste ist die ganze Liste: ein Aufruf an eine andere Adresse wird abgewiesen und protokolliert.

Was für die Verbindung nötig ist

Ein API-Schlüssel

Was sie hinzufügt

Wo sie auftaucht 3
  • In Adminium: seine Karte unter Studio → Zahlungen → Einrichtung, mit der Checkliste Testschlüssel, Test-Webhook, Testzahlung senden, Live-Schlüssel, Live-Webhook, Erste Live-Zahlung eingegangen
  • Auf der Zahlungsseite eines Datensatzes: die Zahlungsarten, die Ihr Konto bei Stripe eingeschaltet hat; jede führt den Kunden auf die Seite von Stripe
  • Im Zahlungsbereich eines Datensatzes und in Aktivität: die Zahlungen, die es angenommen hat, mit ihren Erstattungen und Streitfällen
Tabellen, die sie mitbringt 0

Keine — sie bringt keine eigenen Tabellen mit.

Einstellungen, die Sie festlegen 2
  • Eingeschränkter Schlüssel
  • Signaturgeheimnis des Webhooks

Wenn Sie sie ausschalten

Beim Trennen verschwinden die Oberflächen der Erweiterung. Die von ihr angelegten Tabellen werden nie verworfen, geschriebene Dateien nie gelöscht und hinzugefügte Zeilen nie entfernt — alles, was sie geschrieben hat, bleibt in Ihrer Datenbank. Die ihr anvertrauten Zugangsdaten werden dabei widerrufen und gelöscht.

Was bleibt

Jede bereits erfasste Zahlung und Erstattung bleibt: beim Datensatz, in Aktivität und in Ihrer eigenen Zahlungstabelle, falls Sie eine gewählt haben. Eigene Tabellen hat es nicht mitgebracht. Zahlungsarten von Hand und das Erfassen einer Zahlung von Hand funktionieren wie vorher, und Ihr Konto bei Stripe samt dem Geld darauf bleibt unberührt.

Was verschwindet

„Trennen“ auf seiner Karte bietet zwei Wege. Neue Zahlungen stoppen: Es beginnt keine neue Zahlung, und Adminium behält den Schlüssel, um wartende Zahlungen abzuschließen und Erstattungen zu geben. Schlüssel entfernen: Die Schlüssel werden von diesem Server gelöscht, und Adminium kann über Stripe keine Zahlung mehr abschließen und keine Erstattung mehr geben. Das Entfernen hier sperrt den Schlüssel bei Stripe nicht; erneuern Sie ihn zur Sicherheit im Dashboard von Stripe.

Zur Demo

Keine Demo auf dieser Seite ruft wirklich einen fremden Dienst auf. Jede Erweiterung bringt einen Ersatz-Transport mit, der aus eingebauten Daten antwortet, und der ist von Haus aus eingeschaltet. Echte Zugangsdaten gehören zum Selbsthosten und sind in der README der Erweiterung beschrieben.

So schalten Sie sie ein Keine der Demos auf dieser Website enthält es. Installieren Sie Card payments in Ihrem eigenen Adminium (0.3.33 oder neuer) unter Add-ons, öffnen Sie Studio → Zahlungen und folgen Sie der Checkliste auf seiner Karte, zuerst im Testmodus. Jede Test-Zahlungsseite bietet außerdem den Demo-Dienst an, der gar kein Konto braucht – so lässt sich der ganze Ablauf samt Erstattungen ausprobieren, bevor irgendetwas verbunden ist.

Adminium ist mit diesem Unternehmen nicht verbunden.