Auf einen Blick
- Funktioniert mit
- WooCommerce (klassischer Checkout und Block-Checkout), JetFormBuilder, Contact Form 7, Elementor, Gutenberg
- Voraussetzungen
- WordPress 6.0 oder neuer, PHP 7.4 oder neuer, ein Toreador-Konto mit mindestens einem Empfangs-Wallet
- Wer eine Website verbinden kann
- Der Inhaber oder ein Administrator der Organisation
- Währung
- Ihr Shop in USD oder EUR. Ihre Kunden zahlen in Stablecoins (USDC, USDT, EURC und weiteren), im Netzwerk ihrer Wahl
- Beschriebene Version
- 0.2.2
Plugin installieren
- 1Laden Sie das Toreador-Plugin herunter (eine .zip-Datei).
- 2Öffnen Sie in WordPress Plugins → Neues Plugin hinzufügen → Plugin hochladen, wählen Sie die Datei und klicken Sie auf Jetzt installieren.
- 3Aktivieren Sie es. Im Admin-Menü erscheint der Eintrag Toreador.
Nichts einzuschalten: WooCommerce, JetFormBuilder, Contact Form 7, Elementor und Gutenberg werden erkannt, sobald sie aktiv sind.
Ihre Website verbinden
Sie geben in WordPress nie ein Passwort ein und fügen nie einen Schlüssel ein. Die Website wird über einen Autorisierungsbildschirm bei Toreador verbunden und erhält einen auf diese Website beschränkten Schlüssel, den Sie jederzeit widerrufen können.
- 1Öffnen Sie Toreador im WordPress-Menü und klicken Sie auf Mit Toreador verbinden.
- 2Melden Sie sich bei Bedarf bei Toreador an. Der Autorisierungsbildschirm nennt Ihre Website mit ihrer Domain: Prüfen Sie, dass es Ihre ist.
- 3Wählen Sie die Organisation, zu der die Website gehört, und klicken Sie auf Autorisieren. Sie kehren verbunden zu WordPress zurück.
Die Regeln
- Nur der Inhaber oder ein Administrator der Organisation kann eine Website autorisieren.
- Für einen Produktionsschlüssel verlangt Toreador den an Ihre E-Mail-Adresse gesendeten Code, wenn Ihre Anmeldung mehr als fünf Minuten zurückliegt. Ein Testschlüssel verlangt nichts weiter.
- Der Inhaber der Organisation erhält bei jedem neuen Schlüssel eine E-Mail.
- Der Schlüssel kann Zahlungsanforderungen erstellen und Ihre Zahlungen lesen. Er kann Ihre Empfangs-Wallets nicht ändern.
Nach dem Verbinden prüft die Schaltfläche Verbindung testen jederzeit, ob der Schlüssel noch funktioniert.
WooCommerce
Das Plugin fügt eine Zahlungsart hinzu: In Krypto bezahlen. Sie denken in USD oder EUR; Ihr Kunde wählt Stablecoin und Netzwerk auf einer Toreador-Zahlungsseite und zahlt aus seinem eigenen Wallet.
Die Einstellungen
WooCommerce → Einstellungen → Zahlungen → Toreador.
- Aktivieren: zeigt die Zahlungsart im Checkout an.
- Titel und Beschreibung: was Ihr Kunde im Checkout liest.
- Empfangs-Wallet: eines der Wallets Ihres Toreador-Kontos. Die Adresse wird nie in WordPress eingegeben; Sie fügen Wallets in Ihrem Toreador-Dashboard hinzu und entfernen sie dort.
- Erweiterte Konfiguration: Wählen Sie genau aus, welche Stablecoins und Netzwerke Sie akzeptieren. Standardmässig wird alles angeboten, was mit Ihrem Wallet kompatibel ist.
Was Ihr Kunde sieht
- 1Im Checkout wählt er In Krypto bezahlen und schliesst die Bestellung ab.
- 2Eine Seite zeigt den Betrag und die Schaltfläche Zahlungsseite öffnen. Die Zahlungsseite öffnet sich in einem neuen Tab.
- 3Er wählt einen Stablecoin und ein Netzwerk und zahlt aus seinem Wallet.
- 4Die Bestellseite aktualisiert sich von selbst: Die Bestellung ist bezahlt, mit ihrer Transaktion.
Was Sie in der Bestellung sehen
- Die Bestellung bleibt ausstehend und zahlbar, bis die Zahlung auf der Blockchain bestätigt ist. Danach wechselt sie zu «In Bearbeitung».
- Eine Notiz hält den erhaltenen Betrag, den Stablecoin, das Netzwerk und den Transaktions-Hash fest. Die Bestell-E-Mails enthalten dieselben Angaben.
- Eine Zahlung auf eine ältere Zahlungsanforderung derselben Bestellung wird nicht von selbst angewendet: Die Bestellung wird zur Prüfung zurückgestellt.
Formulare: JetFormBuilder und Contact Form 7
Ein Formular kann mit einer Krypto-Zahlung enden: eine Anzahlung, eine Spende, eine Buchung. Nach dem Absenden erscheint darunter ein Zahlungsfeld.
Öffnen Sie Toreador → Formulare. Alle Formulare Ihrer Website sind aufgeführt; klicken Sie auf Konfigurieren.
- Toreador aktivieren: schaltet die Zahlungsanforderung für dieses Formular ein.
- Empfangs-Wallet: das Standard-Wallet Ihres Kontos oder ein anderes. Es stammt immer aus Ihrem Konto, nie aus einem Feld des Formulars.
- Betrag: von Ihnen festgelegt oder vom Besucher in ein Zahlenfeld eingegeben. Ein eingegebener Betrag wird auf dem Server erneut geprüft, zwischen dem von Ihnen festgelegten Minimum und Maximum.
- Währung: USD oder EUR.
- Seite nach der Zahlung: optional. Ohne sie bleibt der Besucher auf der Seite und liest, dass die Zahlung bestätigt ist.
JetFormBuilder verlangt einen weiteren Schritt im Formular-Editor: Fügen Sie bei den Aktionen nach dem Absenden die Aktion Toreador — Krypto-Zahlungsanforderung hinzu. Dort hat sie keine Einstellung; alles wird unter Toreador → Formulare festgelegt.
Contact Form 7 verlangt nichts weiter. Die Zahlungsanforderung wird auch dann erstellt, wenn die Benachrichtigungs-E-Mail des Formulars nicht versendet werden kann.
Wird das Wallet eines Formulars aus Ihrem Konto entfernt, weist der Bildschirm Formulare darauf hin, und Ihre Besucher lesen, dass die Krypto-Zahlung nicht verfügbar ist.
Zahlungsbereich: Elementor und Gutenberg
Standardmässig erscheint das Zahlungsfeld direkt unter dem Formular. Um es zu platzieren, wo Sie möchten, und es mit Ihrem Builder zu gestalten, fügen Sie den Zahlungsbereich hinzu.
- Gutenberg: Fügen Sie den Block Toreador — Zahlungsbereich hinzu.
- Elementor: Ziehen Sie das Widget Toreador — Zahlungsbereich auf die Seite.
Der Bereich bleibt unsichtbar, bis das Formular abgesendet ist; dann erscheint das Zahlungsfeld darin. Sie können seinen Titel und die Beschriftung seiner Schaltfläche ändern.
Wie eine Zahlung bestätigt wird
Toreador beobachtet die Blockchain. Ihre Website erfährt das Ergebnis auf drei Wegen, damit keine Zahlung verpasst und keine doppelt gezählt wird.
Eine Benachrichtigung in Echtzeit
Toreador sendet Ihrer Website eine signierte Nachricht, sobald die Zahlung bestätigt ist. Dafür braucht es eine öffentliche HTTPS-Adresse; das Plugin registriert sie beim Verbinden.
Die Seite selbst
Während Ihr Kunde wartet, fragt die Seite alle paar Sekunden den Status ab.
Eine Prüfung im Hintergrund
Alle fünf Minuten prüft das Plugin die noch ausstehenden Zahlungen, auch wenn der Kunde die Seite geschlossen hat.
Auf einer Website ohne öffentliche HTTPS-Adresse, etwa einer lokalen Kopie, sind Echtzeit-Benachrichtigungen ausgeschaltet, und der Toreador-Bildschirm sagt es. Die beiden anderen Wege funktionieren weiterhin.
Der Testmodus
- Unter der Schaltfläche Verbinden gibt der Link «im Sandbox-Modus verbinden» der Website einen Testschlüssel.
- Die Zahlungen laufen dann über Testnetzwerke, mit Test-Stablecoins: Es bewegen sich keine echten Gelder.
- Test und Produktion sind getrennt: Ein Testschlüssel sieht nie eine echte Zahlung. Um live zu gehen, trennen Sie die Verbindung und verbinden Sie erneut mit Mit Toreador verbinden.
Meldungen, die Sie sehen können
« Der API-Schlüssel wurde widerrufen oder ist nicht mehr gültig »
Warum — Die Website wurde unter Verbundene Apps in Toreador getrennt, oder ihr Schlüssel wurde widerrufen.
Was zu tun ist — Verbinden Sie die Website erneut. Bis dahin wird Krypto aus dem Checkout entfernt.
« Dieses Wallet ist nicht mehr in Ihrem Toreador-Konto »
Warum — Das in WooCommerce oder in einem Formular eingestellte Empfangs-Wallet wurde aus Ihrem Konto entfernt.
Was zu tun ist — Wählen Sie in den Einstellungen ein anderes Wallet.
« Kontingent des Tarifs erreicht »
Warum — Die Anzahl der in Ihrem Tarif enthaltenen bestätigten Zahlungen ist erreicht.
Was zu tun ist — Krypto wird für eine Stunde pausiert; Ihre anderen Zahlungsarten funktionieren weiter. Wechseln Sie den Tarif, um sofort fortzufahren.
« Echtzeit-Benachrichtigungen: inaktiv »
Warum — Die Website hat keine öffentliche HTTPS-Adresse, oder Ihr Tarif enthält keine Echtzeit-Benachrichtigungen.
Was zu tun ist — Nichts geht verloren: Die Seite und die Prüfung im Hintergrund bestätigen die Zahlungen weiterhin.
« Die Krypto-Zahlung ist derzeit nicht verfügbar »
Warum — Das liest Ihr Kunde in einem der oben genannten Fälle.
Was zu tun ist — Er kann eine andere Zahlungsart wählen. Öffnen Sie den Toreador-Bildschirm, um die Ursache zu sehen.
Für Entwickler
Das Plugin bietet drei Funktionen, einen Shortcode und zwei Hooks. Die Funktionen geben eine Zahlung nur an den Kunden der Bestellung zurück, sofern Ihr Servercode nichts anderes verlangt.
toreador_order_payment( $order )— Die Zahlung einer WooCommerce-Bestellung: Status, Stablecoin, Netzwerk, Betrag, Transaktion, Link zum Explorer.toreador_is_paid( $order )— Wahr, sobald die Zahlung bestätigt ist.toreador_create_payment( $args )— Erstellt eine Zahlungsanforderung aus Ihrem eigenen Code und gibt ihre Zahlungsseite zurück. Die Empfangsadresse muss ein Wallet Ihres Kontos sein.[toreador_order_payment id="123"]— Zeigt dem Kunden einer Bestellung die Details ihrer Zahlung.toreador_payment_completed— Wird ausgelöst, wenn eine Bestellung bezahlt ist.toreador_payment_status_changed— Wird ausgelöst, wenn eine Formularzahlung bezahlt, abgelaufen oder fehlgeschlagen ist.
PHP
// Wird ausgelöst, wenn eine Bestellung bezahlt ist.
add_action( 'toreador_payment_completed', function ( $order_id, $payment ) {
// $payment['token'], $payment['chain'], $payment['amount'], $payment['tx']
}, 10, 2 );
// Erstellt eine Zahlungsanforderung aus Ihrem eigenen Code und gibt ihre Zahlungsseite zurück. Die Empfangsadresse muss ein Wallet Ihres Kontos sein.
$request = toreador_create_payment( array(
'amount' => 50,
'currency' => 'USD',
'recipient' => '0x…', // Empfangs-Wallet
'reference' => 'booking-1042',
) );
if ( $request['ok'] ) {
wp_redirect( $request['pay_url'] );
}Trennen und deinstallieren
- Trennen, im Toreador-Bildschirm von WordPress, lässt die Website ihren Schlüssel vergessen. Um den Schlüssel selbst zu widerrufen, öffnen Sie Verbundene Apps in Ihrem Toreador-Dashboard und klicken Sie auf Trennen.
- Das Löschen des Plugins entfernt seine Einstellungen, seinen Schlüssel und seine geplante Aufgabe. Ihre Bestellungen und deren Zahlungsnotizen bleiben erhalten.
Was das Plugin an Toreador sendet
Nur was eine Zahlung braucht: den Betrag, die Währung, Ihre Empfangsadresse, eine Bestellreferenz und die Herkunft (WooCommerce oder der Formular-Builder). Die persönlichen Daten Ihrer Kunden werden nie gesendet.