KI-Zusammenfassung
Möchten Sie Zahlungen von Kunden in Nigeria, Ghana, Kenia oder Südafrika akzeptieren? Käufer in diesen Ländern erwarten, mit den Methoden zu bezahlen, die sie täglich nutzen, wie z. B. lokale Karten, Banküberweisungen und mobiles Geld.
Das Paystack Addon verbindet Ihre Formulare mit Paystack, sodass Käufer ihre Zahlung in einem sicheren Popup abschließen können, ohne Ihre Website zu verlassen. Diese Anleitung zeigt Ihnen, wie Sie das Paystack Addon mit WPForms installieren und verwenden.
Voraussetzungen:
- Sie benötigen eine Pro-Lizenz oder höher, um auf das Paystack Addon zugreifen zu können.
- Stellen Sie sicher, dass Sie WPForms Version 2.0.2.2 oder höher installiert haben, um die mindestens erforderliche Version für das Paystack Addon zu erfüllen.
- Sie benötigen ein Paystack-Konto, das in Nigeria, Ghana, Kenia oder Südafrika registriert ist.
Bevor Sie beginnen, stellen Sie sicher, dass Sie WPForms installieren und aktivieren auf Ihrer WordPress-Website. Nach der Überprüfung Ihrer Lizenz können Sie das Paystack Addon schnell installieren und aktivieren.
Paystack mit Ihrer Website verbinden
Sobald das Paystack Addon installiert und aktiviert ist, müssen Sie Ihr Paystack-Konto mit WPForms verbinden. Dazu kopieren Sie Ihre API-Schlüssel aus Ihrem Paystack-Dashboard in Ihre WPForms-Zahlungseinstellungen. Wir führen Sie Schritt für Schritt durch.
Ihre Paystack API-Schlüssel abrufen
Um zu beginnen, melden Sie sich in Ihrem Paystack-Dashboard an. Klicken Sie dann unten im Menü auf der linken Seite auf Einstellungen.
Öffnen Sie dort den Tab API-Schlüssel & Webhooks.
Paystack zeigt die Schlüssel für den Modus an, in dem sich Ihr Dashboard befindet. Um echte Zahlungen zu akzeptieren, benötigen Sie Ihre Live-Schlüssel, die unter API-Konfiguration – Live-Modus aufgeführt sind.
Hinweis: Neue Paystack-Konten starten im Testmodus, und Live-Schlüssel sind erst verfügbar, nachdem Paystack Ihr Unternehmen aktiviert hat. Um es zu aktivieren, öffnen Sie die Seite Compliance in Ihrem Paystack-Dashboard, füllen Sie jeden Abschnitt aus und klicken Sie auf Unternehmen aktivieren. Ihr Dashboard wechselt in den Live-Modus, sobald Paystack Ihre Daten genehmigt hat. Die vollständigen Schritte finden Sie in Paystacks Anleitung zur Aktivierung Ihres Unternehmens.
Während Sie auf die Genehmigung warten, können Sie das Addon weiterhin mit Ihren Testschlüsseln ausprobieren. Sehen Sie sich den Abschnitt Paystack-Zahlungen testen unten an.
Klicken Sie als Nächstes auf das Augen-Symbol neben Ihrem Live Secret Key. Paystack fragt Sie nach Ihrem Kontopasswort, bevor der Schlüssel angezeigt wird. Kopieren Sie dann den Schlüssel.
Kopieren Sie danach Ihren Live Public Key aus dem Feld darunter.
Lassen Sie diese Seite geöffnet. Sie werden beide Schlüssel im nächsten Schritt in WPForms einfügen und hierher zurückkehren, um Ihre Webhook-URL hinzuzufügen.
Die Verbindung in WPForms abschließen
Gehen Sie in Ihrem WordPress-Adminbereich zu WPForms » Einstellungen und klicken Sie auf die Registerkarte Zahlungen.
Überprüfen Sie zuerst die Einstellung Währung oben auf der Seite. Sie muss mit der Währung des Landes übereinstimmen, in dem Ihr Paystack-Konto registriert ist. Zum Beispiel benötigt ein kenianisches Konto den Kenyan Shilling (KES).
Hinweis: Jedes Paystack-Konto verarbeitet Zahlungen in einer einzigen Währung, die durch das Land festgelegt wird, das Sie bei der Anmeldung gewählt haben. Wenn die WPForms-Währung nicht übereinstimmt, sehen Sie eine Warnung in Ihren Zahlungseinstellungen, und Zahlungen werden nicht durchgeführt, bis die Währungen übereinstimmen.
Scrollen Sie als Nächstes nach unten zum Abschnitt Paystack. Fügen Sie Ihren geheimen Schlüssel in das Feld Live Secret Key ein. Fügen Sie dann Ihren öffentlichen Schlüssel in das Feld Live Public Key ein.
Wenn Sie fertig sind, klicken Sie auf Einstellungen speichern.
WPForms überprüft Ihren geheimen Schlüssel mit Paystack und prüft, ob beide Schlüssel zu dem von Ihnen gewählten Modus gehören. Wenn ein Schlüssel falsch eingegeben wurde oder zum anderen Modus gehört, sehen Sie sofort eine Fehlermeldung. Live-Schlüssel beginnen mit sk_live_ und pk_live_, während Testschlüssel mit sk_test_ und pk_test_ beginnen. Wenn die Verbindung funktioniert, zeigt der Verbindungsstatus Mit Paystack im Live-Modus verbunden an.
Hinweis: Testmodus und Live-Modus verwenden jeweils ihr eigenes Schlüsselpaar. Um die Paystack-Integration Ihres Formulars zu testen, bevor Sie echte Zahlungen erhalten, siehe den Abschnitt Testen von Paystack-Zahlungen unten.
Paystack Webhooks einrichten
Webhooks sind die Art und Weise, wie Paystack Ihre Website über Zahlungsaktualisierungen informiert, die nach der Übermittlung Ihres Formulars durch einen Kunden erfolgen. Zum Beispiel teilt ein Webhook WPForms mit, wenn eine Banküberweisung eintrifft oder wenn Sie eine Zahlung über Ihr Paystack-Dashboard zurückerstatten.
Paystack erlaubt es WPForms nicht, einen Webhook für Sie hinzuzufügen. Daher kopieren Sie eine URL aus WPForms und fügen sie selbst in Ihr Paystack-Dashboard ein. Es dauert nur eine Minute und Sie müssen es nur einmal für jeden Modus tun.
Nachdem Sie Ihre Schlüssel gespeichert haben, erscheinen im Paystack-Abschnitt 2 neue Einstellungen. Lassen Sie Webhooks aktivieren eingeschaltet. Klicken Sie dann auf das Kopiersymbol neben dem Feld Webhooks Endpoint, um Ihre Webhook-URL zu kopieren.
Gehen Sie nun zurück zur Seite API-Schlüssel & Webhooks in Ihrem Paystack-Dashboard. Fügen Sie die URL in das Feld Live Webhook URL ein. Klicken Sie dann auf Änderungen speichern.
WPForms empfängt nun Zahlungsaktualisierungen von Paystack.
Hinweis: Paystack führt separate Webhook-Einstellungen für den Testmodus und den Live-Modus, aber WPForms verwendet für beide die gleiche URL. Wenn Sie zuerst testen, fügen Sie die URL in das Feld Test Webhook URL ein. Wenn Sie beide Modi verwenden, fügen Sie sie zu beiden Feldern hinzu.
Paystack zu Ihren Formularen hinzufügen
Nachdem Sie Ihr Konto verbunden haben, können Sie Zahlungen in Ihren Formularen akzeptieren. Erstellen Sie dazu ein neues Formular oder bearbeiten Sie ein vorhandenes, um den Formular-Generator zu öffnen.
Ihr Formular benötigt mindestens ein Zahlungsfeld, das einen Betrag festlegt, wie z. B. Einzelartikel, Mehrere Artikel, Kontrollkästchenelemente oder Dropdown-Elemente. Es benötigt auch ein E-Mail-Feld, da Paystack die E-Mail-Adresse des Kunden benötigt. Es gibt kein separates Paystack-Feld zum Hinzufügen. Paystack erfasst die Zahlungsdetails in einem eigenen Popup, wenn das Formular gesendet wird.
Gehen Sie als Nächstes im Formularersteller zu Zahlungen » Paystack und aktivieren Sie den Schalter Paystack-Zahlungen aktivieren.
Füllen Sie dann die Einstellungen für die Zahlungen dieses Formulars aus:
- Zahlungsbeschreibung: Eine kurze Beschreibung der Zahlung, z. B. Ihr Produkt- oder Dienstleistungsname. Sie wird in den Zahlungsdetails in Ihrem Paystack-Dashboard angezeigt.
- Kunden-E-Mail: Das Feld in Ihrem Formular, das die E-Mail-Adresse des Kunden enthält. Diese Einstellung ist erforderlich. Paystack benötigt eine E-Mail-Adresse, um die Zahlung zu erstellen, und sendet die Quittung an diese Adresse.
- Kundenname: Das Feld in Ihrem Formular, das den Namen des Kunden enthält. Es wird in den Zahlungsdetails in Ihrem Paystack-Dashboard angezeigt.
Wenn Ihr Formular bereits ein E-Mail-Feld und ein Namensfeld hat, wählt WPForms diese für Sie aus.
Hinweis: Paystack-Zahlungen erfordern die AJAX-Formularübermittlung, die für neue Formulare standardmäßig aktiviert ist. Wenn sie deaktiviert ist, erinnert Sie WPForms daran, wenn Sie das Formular speichern. Um sie wieder zu aktivieren, gehen Sie zu Einstellungen » Allgemein, öffnen Sie den Abschnitt Erweitert und aktivieren Sie AJAX-Formularübermittlung aktivieren.
Wenn Sie fertig sind, speichern Sie Ihr Formular. Es ist nun bereit, Zahlungen zu akzeptieren.
Wie Kunden mit Paystack bezahlen
Wenn ein Kunde Ihr Formular sendet, öffnet sich ein Paystack-Popup über der Seite. Das Formular wird erst gesendet, nachdem die Zahlung abgeschlossen ist.
Die Zahlungsoptionen im Popup hängen von der Währung Ihres Paystack-Kontos ab:
- Nigerianische Naira (NGN): Karte und Banküberweisung
- Ghanaische Cedi (GHS): Karte und mobile Geldüberweisung
- Kenianischer Schilling (KES): Karte und mobile Geldüberweisung
- Südafrikanischer Rand (ZAR): Karte
Sobald die Zahlung erfolgreich war, schließt sich das Popup und der Kunde sieht die Bestätigungsnachricht Ihres Formulars.
Paystack-Zahlungen testen
Bevor Sie echte Zahlungen annehmen, ist es eine gute Idee, selbst eine Zahlung über Ihr Formular abzuwickeln. Der Testmodus von Paystack ermöglicht es Ihnen, den gesamten Ablauf abzuschließen, ohne dass Geld bewegt wird.
Testmodus aktivieren
Um sicherzustellen, dass während des Testens keine echten Zahlungen verarbeitet werden, gehen Sie zu WPForms » Einstellungen und klicken Sie auf den Tab Zahlungen.
Unter Paystack aktivieren Sie den Schalter Testmodus. Die Felder Test Secret Key und Test Public Key erscheinen anstelle der Live-Schlüssel.
Hinweis: Testmodus und Live-Modus werden separat eingerichtet, daher müssen Sie Ihre Testschlüssel hier hinzufügen, auch wenn Sie Ihre Live-Schlüssel bereits verbunden haben. WPForms wird Sie daran erinnern, wenn Sie den Modus wechseln.
Gehen Sie als Nächstes zurück zur Seite API-Schlüssel & Webhooks in Ihrem Paystack-Dashboard. Wenn sich Ihr Dashboard im Live-Modus befindet, verwenden Sie den Schalter oben rechts im Dashboard, um zum Testmodus zu wechseln.
Kopieren Sie Ihren Test-Geheimschlüssel und fügen Sie ihn in das Feld Test-Geheimschlüssel in WPForms ein. Tun Sie dann dasselbe für Ihren Test-Öffentlichen Schlüssel.
Klicken Sie auf Einstellungen speichern. Der Verbindungsstatus wird als Mit Paystack im Testmodus verbunden angezeigt.
Um Webhooks während des Testens zu empfangen, fügen Sie Ihre Webhook-Endpunkt-URL auch in das Feld Test-Webhook-URL in Ihrem Paystack-Dashboard ein.
Eine Testzahlung durchführen
Öffnen Sie als Nächstes eine Seite mit Ihrem Paystack-Formular und füllen Sie sie so aus, wie es ein Kunde tun würde. Senden Sie dann das Formular ab, um das Paystack-Popup zu öffnen.
Im Testmodus zeigt die Option Karte Testszenarien anstelle von Kartenfeldern an. Wählen Sie Erfolg und klicken Sie auf die Schaltfläche Bezahlen, um eine erfolgreiche Testzahlung abzuschließen. Um zu sehen, wie Ihr Formular eine fehlgeschlagene Zahlung behandelt, wählen Sie stattdessen Abgelehnt.
Um Kartendetails selbst einzugeben, klicken Sie auf Andere Karte verwenden und verwenden Sie eine der Testkarten von Paystack. Zum Beispiel vervollständigt die Kartennummer 4084 0840 8408 4081 mit CVV 408 und einem beliebigen zukünftigen Ablaufdatum eine erfolgreiche Zahlung. Dieselbe Seite listet auch Testnummern für Mobile Money und Banküberweisungen auf.
Ihre Testzahlungen anzeigen
Um Ihre Testzahlungen zu finden, gehen Sie zu WPForms » Zahlungen und aktivieren Sie den Schalter Testdaten.
Klicken Sie auf eine Zahlung, um deren Details anzuzeigen. Von dort öffnet der Link In Paystack anzeigen die Transaktion in Ihrem Paystack-Dashboard.
Weitere Informationen zu Zahlungsdetails, -status und -trends finden Sie in unserem Leitfaden zum Anzeigen und Verwalten von Zahlungen.
Einrichtung bedingter Logik (Optional)
Bedingte Logik ermöglicht es Ihnen zu entscheiden, wann eine Paystack-Zahlung verarbeitet werden soll, basierend auf der Auswahl des Kunden in Ihrem Formular. Sie möchten beispielsweise möglicherweise nur Kunden belasten, die eine kostenpflichtige Option wählen.
Um dies einzurichten, gehen Sie im Formular-Builder zu Zahlungen » Paystack und aktivieren Sie Bedingte Logik aktivieren. Erstellen Sie dann die Regel, die entscheidet, wann die Zahlung verarbeitet werden soll.
Weitere Beispiele finden Sie in unserem Tutorial zur Verwendung bedingter Logik.
Häufig gestellte Fragen
Nachfolgend haben wir einige der häufigsten Fragen zur Verwendung des Paystack-Addons beantwortet.
Welche Länder und Währungen kann ich mit dem Paystack Addon verwenden?
Das Addon funktioniert mit Paystack-Konten, die in Nigeria, Ghana, Kenia und Südafrika registriert sind. Jedes Konto verarbeitet Zahlungen in der Währung seines Landes: Nigerianische Naira (NGN), Ghanaischer Cedi (GHS), Kenianischer Schilling (KES) oder Südafrikanischer Rand (ZAR). Stellen Sie die entsprechende Währung in WPForms » Einstellungen » Zahlungen ein.
Warum wird meine Paystack-Zahlung als ausstehend markiert?
Banküberweisungen und Mobile-Money-Zahlungen können etwas länger dauern, bis sie bestätigt werden, als Kartenzahlungen. Wenn ein Kunde eine dieser Optionen wählt und das Popup schließt, bevor Paystack die Zahlung bestätigt, speichert WPForms den Eintrag und markiert die Zahlung als ausstehend.
Bis zur Bestätigung der Zahlung hält WPForms die Benachrichtigungs-E-Mails des Formulars zurück. Es wartet auch darauf, mit dem User Registration Addon erstellte Konten zu aktivieren und die Verwendung von Gutscheinen zu zählen. Sobald Paystack die Zahlung bestätigt hat, markiert WPForms sie als abgeschlossen und führt diese Schritte aus. Mit eingerichteten Webhooks dauert dies normalerweise einige Sekunden. Ohne sie kann es bis zu 30 Minuten dauern.
Muss ich Webhooks einrichten?
Wir empfehlen es. Ohne Webhooks prüft WPForms alle 15 Minuten mit Paystack und aktualisiert wartende Zahlungen, sodass Banküberweisungen und Mobile-Money-Zahlungen trotzdem abgeschlossen werden. Kartenzahlungen bleiben bis zu 30 Minuten lang als „Bearbeitet“ markiert, bis diese Prüfung sie als „Abgeschlossen“ kennzeichnet. Rückerstattungen, die Sie in Ihrem Paystack-Dashboard vornehmen, werden jedoch nicht mit WPForms synchronisiert.
Wenn WPForms feststellt, dass Zahlungen nur durch diese Prüfungen aktualisiert werden, wird in Ihrem WordPress-Adminbereich eine Benachrichtigung angezeigt, die Sie auffordert, Ihre Webhook-Einrichtung zu überprüfen. Um dies zu beheben, kopieren Sie die URL des Webhook-Endpunkts aus WPForms » Einstellungen » Zahlungen in das Feld Webhook-URL für den Modus, den Sie in Ihrem Paystack-Dashboard verwenden.
Warum steht auf meinem Formular „Zahlungen sind derzeit nicht verfügbar“?
Diese Meldung erscheint, wenn WPForms eine Paystack-Zahlung in Ihrem Formular nicht verarbeiten kann. Hier sind die häufigsten Ursachen und wie Sie jede einzelne beheben können:
- Paystack ist im aktuellen Modus nicht verbunden: Zum Beispiel ist der Testmodus aktiviert, aber es sind keine Testschlüssel gespeichert. Gehen Sie zu WPForms » Einstellungen » Zahlungen und fügen Sie die Schlüssel für den von Ihnen verwendeten Modus hinzu.
- Die Währungen stimmen nicht überein: Paystack verarbeitet Zahlungen nur in der Währung Ihres Kontos. Daher pausiert die Änderung der WPForms-Währung die Zahlungen. Stellen Sie die Währung wieder so ein, dass sie mit Ihrem Paystack-Konto übereinstimmt.
- AJAX-Formularübermittlung ist deaktiviert: Paystack-Zahlungen erfordern eine AJAX-Formularübermittlung, und einige Formularvorlagen, einschließlich der Vorlagen für die Benutzerregistrierung, haben diese standardmäßig deaktiviert. Um sie zu aktivieren, öffnen Sie die Einstellungen Ihres Formulars » Allgemein, erweitern Sie Erweitert und aktivieren Sie AJAX-Formularübermittlung aktivieren.
Warum sehe ich „Der Zahlungsbetrag liegt unter dem Mindestbetrag“?
Paystack legt für jede Währung einen Mindestbetrag fest, und WPForms prüft den Gesamtbetrag, bevor das Popup geöffnet wird. Die Mindestbeträge sind 50 NGN, 0,10 GHS, 3 KES und 1 ZAR. Wenn der Gesamtbetrag Ihres Formulars unter diesen Betrag fallen kann, passen Sie Ihre Preise an oder verwenden Sie bedingte Logik, um die Abbuchung für diese Bestellungen zu überspringen.
Speichert WPForms die Kartendetails meiner Kunden?
Nein. Das Paystack-Popup wird von Paystack gehostet, sodass Kartendetails direkt an Paystack gesendet werden und niemals Ihre Website berühren. WPForms speichert nur den Zahlungsdatensatz zusammen mit der Kartenmarke und den letzten 4 Ziffern zu Ihrer Information.
Das ist alles! Sie können jetzt Zahlungen per Karte, Überweisung und mobilem Geld über das WPForms Paystack Addon akzeptieren.
Möchten Sie als Nächstes die eingehenden Zahlungen über Ihre Formulare genauer verfolgen? Lesen Sie unseren Leitfaden zum Anzeigen und Verwalten von Zahlungen, um Details, Status und Rückerstattungen zu erfahren.
