Wallet payments
Überblick
Verbindet mit PayPal. Ihre Kunden bezahlen eine Rechnung oder jeden Datensatz mit einem Betrag mit ihrem Konto bei PayPal, auf der Seite von PayPal. Dort gibt der Kunde die Zahlung frei und kommt zurück; dann zieht Adminium das Geld ein (PayPal nennt das „Capture“) und erfasst es einmal beim Datensatz. Kommt der Kunde nie zurück, zieht der Webhook oder die eigene Prüfung von Adminium es stattdessen ein, und eine Zahlung, die PayPal zurückhält, erscheint als „in Bearbeitung“, mit dem Grund, den PayPal nennt. Ihr Betrieb ist der Verkäufer: Er braucht ein eigenes Geschäftskonto bei PayPal (PayPal Business), und das Geld geht vom Kunden direkt auf dieses Konto. Adminium hat kein Zahlungskonto, keine eigenen Zugangsdaten und kein Geld und wickelt nichts ab; nichts, was der Kunde auf der Seite von PayPal eingibt, erreicht Ihren Server. Eingerichtet wird es in Studio → Zahlungen, zuerst in der Sandbox: eine REST-App mit Client-ID und Geheimnis und ein Webhook je Modus, dann eine Testzahlung als Sandbox-Käufer, die nichts in Ihre Tabellen schreibt. Erstattungen gehen vom Zahlungsbereich eines Datensatzes oder von Aktivität aus, und eine Erstattung im Dashboard von PayPal wird ebenfalls erfasst. Eine angefochtene Zahlung wird verfolgt, bis PayPal den Streitfall entscheidet; beantwortet wird er im Dashboard von PayPal. Es bietet eine einzige Zahlungsart, das Konto des Kunden bei PayPal, und nimmt die 24 Währungen an, die PayPal annimmt, HUF, JPY und TWD nur in ganzen Einheiten. Es braucht Adminium 0.3.33 oder neuer unter einer öffentlichen https-Adresse auf Port 443, an die PayPal seine Webhooks schickt.
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 eine REST-App aus Ihrem eigenen Geschäftskonto bei PayPal, einmal für die Sandbox und einmal für den Live-Modus: ihre Client-ID, ihr Geheimnis und die ID ihres Webhooks. Das Geheimnis öffnet das ganze Konto bei PayPal – PayPal hat keinen enger gefassten Schlüssel –, deshalb werden alle drei je Modus verschlüsselt auf Ihrem Server gespeichert, und kein Teil der Erweiterung erreicht je einen Browser. Die Signatur jedes Webhooks wird mit der Webhook-ID auf Ihrem Server geprüft. Zahlungen werden nur zu den Zeilen der Tabellen geschrieben, die Sie unter „Was bezahlt werden kann“ wählen. Seine Serverhälfte darf die sechs Adressen unten aufrufen und sonst nichts.
Adressen, die ihr Servercode erreichen darf
- api-m.paypal.com
- api-m.sandbox.paypal.com
- www.paypal.com
- www.sandbox.paypal.com
- api.paypal.com
- api.sandbox.paypal.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 Sandbox-App, Sandbox-Webhook, Testzahlung senden, Live-App, Live-Webhook, Erste Live-Zahlung eingegangen
- Auf der Zahlungsseite eines Datensatzes: „Mit PayPal bezahlen“, das den Kunden auf die Seite von PayPal führt
- 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 3
- Client-ID
- Geheimnis
- Webhook-ID
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 PayPal 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 die Zugangsdaten, um wartende Zahlungen abzuschließen und Erstattungen zu geben. Schlüssel entfernen: Die Zugangsdaten werden von diesem Server gelöscht, und Adminium kann über PayPal keine Zahlung mehr abschließen und keine Erstattung mehr geben. Das Entfernen hier sperrt sie bei PayPal nicht; erstellen Sie zur Sicherheit im Entwickler-Dashboard von PayPal ein neues Geheimnis für die App.
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 Wallet 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 in der Sandbox. 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.