DE
EUR
Zurück

VibeFox IntaSend for WooCommerce — Hilfe

Anforderungen

WordPress: 6.2 oder neuer.

WooCommerce: 8.0 oder neuer, installiert und aktiv. Ohne WooCommerce lässt sich das Plugin nicht aktivieren.

PHP: 8.0 oder neuer.

HTTPS: IntaSend verlangt HTTPS für Live-Zahlungen und Webhooks. Die Einstellungsseite warnt Sie, wenn der Live-Modus aktiv ist und die Shop-Adresse kein HTTPS verwendet.

IntaSend-Konto: Sie benötigen den öffentlichen Schlüssel (ISPubKey_...) und den geheimen Schlüssel (ISSecretKey_...) Ihres IntaSend-Kontos, für die Sandbox, für Live oder für beide, sowie einen Webhook mit Challenge-Phrase im IntaSend-Dashboard (siehe Konfiguration). Der öffentliche Schlüssel erstellt die Kasse. Der geheime Schlüssel wird nur auf Ihrem Server verwendet, um bei IntaSend den Zahlungsstatus abzufragen.

Shop-Währung: KES, USD, EUR, GBP, UGX, TZS, NGN, GHS, XAF oder XOF. Bei anderen Währungen wird die Zahlungsmethode ausgeblendet.

VibeFox-Lizenzschlüssel: wird auf vibefox.net gekauft. Ein Schlüssel funktioniert für eine Domain.

Installation

1. Gehen Sie in WordPress zu Plugins > Add New > Upload Plugin, wählen Sie die ZIP-Datei des Plugins und klicken Sie auf Install Now. Alternativ können Sie den Ordner wcp_intasend_pay per FTP nach /wp-content/plugins/ hochladen.

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Payments > IntaSend > Manage, oder klicken Sie auf der Seite Plugins unter dem Namen des Plugins auf Settings.

4. Geben Sie Ihren VibeFox-Lizenzschlüssel im Lizenzblock oben auf der Seite ein und klicken Sie auf Activate.

5. Fügen Sie Ihre IntaSend-Schlüssel für Sandbox und/oder Live ein, legen Sie den Webhook im IntaSend-Dashboard an und tragen Sie im Plugin dieselbe Challenge-Phrase ein (siehe Konfiguration).

6. Aktivieren Sie Enable/Disable. Testen Sie eine Zahlung bei aktivierter Test mode und deaktivieren Sie danach Test mode, um echte Zahlungen anzunehmen.

Konfiguration

Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Payments > IntaSend. Über den Feldern zeigt ein Statusfeld entweder Test mode: IntaSend sandbox, no real money is charged. oder Live mode: real payments are accepted. an. Es warnt außerdem, wenn die Schlüssel des aktuellen Modus fehlen oder falsch sind (die Zahlungsmethode wird dann an der Kasse ausgeblendet), wenn die Shop-Währung nicht unterstützt wird, wenn keine Webhook-Challenge gesetzt ist und wenn der Live-Modus ohne HTTPS verwendet wird. In der Liste der Zahlungsmethoden ist IntaSend als „Einrichtung erforderlich“ markiert, bis die Schlüssel des aktuellen Modus korrekt sind. Eingefügte Schlüssel werden beim Speichern von Leerzeichen bereinigt.

Allgemein

Enable/Disable: Enable IntaSend schaltet die Zahlungsmethode ein oder aus. Standard: aus.

Title: der Name der Zahlungsmethode, den Kunden an der Kasse sehen. Standard: IntaSend (M-Pesa, card).

Description: der Text, der an der Kasse unter der Zahlungsmethode angezeigt wird. Standard: You will be redirected to IntaSend to pay securely with M-Pesa, card or another available method.

API-Schlüssel

Die Schlüssel finden Sie im IntaSend-Dashboard unter Settings > API Keys, getrennt im Sandbox-Dashboard und im Live-Dashboard. Der Testmodus verwendet die Sandbox-Schlüssel und die Sandbox-API, der Live-Modus die Live-Schlüssel und die Live-API. Das Plugin prüft, ob der öffentliche Schlüssel mit ISPubKey_ und der geheime Schlüssel mit ISSecretKey_ beginnt und ob die Schlüssel zum aktuellen Modus gehören: Sandbox-Schlüssel enthalten _test, Live-Schlüssel enthalten _live. Ist das nicht der Fall, wird die Zahlungsmethode ausgeblendet, und das Statusfeld erklärt den Grund.

Test mode: Use the IntaSend sandbox (no real money is charged). Standard: aktiviert. Deaktivieren Sie die Option, um echte Zahlungen mit den Live-Schlüsseln anzunehmen. Solange der Testmodus aktiviert ist, zeigt die Kasse unter der Zahlungsmethode TEST MODE - IntaSend sandbox, no real money is charged. an.

Sandbox publishable key: beginnt mit ISPubKey_test. Er identifiziert Ihr Unternehmen, wenn eine Kasse erstellt wird.

Sandbox secret key: beginnt mit ISSecretKey_test. Wird nur auf Ihrem Server verwendet, um Zahlungen über die Payment Status API zu bestätigen.

Live publishable key: beginnt mit ISPubKey_live.

Live secret key: beginnt mit ISSecretKey_live. Wird nur auf Ihrem Server verwendet, um Zahlungen zu bestätigen.

Webhook

Der Webhook teilt Ihrem Shop mit, dass eine Zahlung erfolgt ist, auch wenn der Kunde nicht zum Shop zurückkehrt (Browser geschlossen, M-Pesa erst später bestätigt). Öffnen Sie im IntaSend-Dashboard, im Sandbox- und im Live-Bereich, den Punkt Webhooks und fügen Sie die URL hinzu, die in diesem Abschnitt der Einstellungen angezeigt wird. Sie hat die Form https://your-site/wc-api/intasend_pay/. Geben Sie dort eine Challenge-Phrase ein und dieselbe Phrase im Plugin. Verwenden Sie für Sandbox und Live dieselbe Challenge.

Webhook challenge: dieselbe Challenge wie im IntaSend-Dashboard. Webhooks mit einer anderen Challenge werden abgelehnt. Solange dieses Feld leer ist, werden Webhooks nicht verarbeitet, und Zahlungen werden nur bestätigt, wenn der Kunde zum Shop zurückkehrt. Solche Webhooks erhalten die Antwort Ignored und keinen Fehler, damit IntaSend den Webhook nicht deaktiviert, bevor Sie die Challenge eingeben.

Das Plugin reagiert auf diese von IntaSend gemeldeten Zahlungsstatus. Vor jeder Änderung der Bestellung fragt es bei der Payment Status API den tatsächlichen Status ab:

COMPLETE: die Zahlung wurde geleistet. Nach der Prüfung von Betrag und Währung wird die Bestellung als bezahlt markiert.
FAILED or CANCELED: die Zahlung ist fehlgeschlagen. Die Bestellung wird auf „Fehlgeschlagen“ gesetzt, wenn sie noch auf diesen Zahlungsversuch wartet.
PARTIAL: die Rechnung wurde teilweise bezahlt. Die Bestellung wird in Wartestellung gesetzt.
PENDING, PROCESSING or RETRY: die Zahlung läuft noch. Die Bestellung bleibt unverändert, bis der endgültige Status eintrifft.

Benachrichtigungen, die keine Kassenzahlungen dieses Shops sind, zum Beispiel Zahlungslinks oder Geldsendevorgänge desselben IntaSend-Kontos, werden mit OK beantwortet und ignoriert, damit IntaSend den Webhook nicht deaktiviert.

Erweitert

Debug log: Log checkout, return and webhook events unter WooCommerce > Status > Logs, Quelle wcp_intasend_pay. Fehler werden immer protokolliert. API-Schlüssel und Kundendaten werden nie protokolliert. Standard: aus.

Delete data on uninstall: Delete the gateway settings and logs when the plugin is deleted. IntaSend-Referenzen, die in Bestellungen gespeichert sind, gehören zur Zahlungshistorie und bleiben immer erhalten. Das Deaktivieren des Plugins löscht nie etwas. Standard: aus.

Kasse

Der Kunde wählt die Zahlungsmethode (standardmäßig IntaSend (M-Pesa, card)) und gibt die Bestellung auf. Das Plugin erstellt für den Bestellbetrag in der Bestellwährung eine IntaSend-Kasse und leitet den Kunden zur von IntaSend gehosteten Kasse weiter. Dort bezahlt der Kunde mit M-Pesa, Karte oder einer anderen in Ihrem IntaSend-Konto aktivierten Methode. Rechnungs-E-Mail, Name, Adresse, Telefonnummer und Land werden an IntaSend übergeben, wenn sie den Feldregeln von IntaSend entsprechen. Leere oder ungeeignete Felder werden weggelassen.

Nach der Zahlung kehrt der Kunde zu Ihrem Shop zurück. Die Bestellung wird erst als bezahlt markiert, wenn IntaSend die Zahlung bestätigt: Das Plugin fragt die Payment Status API ab, wenn der Kunde zurückkehrt und wenn der Webhook eintrifft. Ist die Zahlung noch nicht bestätigt, zeigt die Seite „Bestellung eingegangen“ Your payment is being confirmed by IntaSend (M-Pesa confirmations can take a minute). You will receive an e-mail as soon as it is confirmed. an. Wurde die Bestellung in Wartestellung gesetzt, zeigt sie Your payment was received and your order is being reviewed. We will contact you if anything is needed. an.

Ist die Zahlung fehlgeschlagen oder ist der Kunde ohne Zahlung zurückgekehrt, kehrt er zur Kasse (oder zur Seite Pay for order) zurück. Dort sieht er The payment was not successful. Please try again or choose another payment method. (mit dem Grund von IntaSend, falls angegeben) oder The payment was not completed. Please try again or choose another payment method. Der Kunde kann die Bestellung erneut bezahlen. Jeder Versuch erhält eine eigene IntaSend-Referenz.

Kann IntaSend die Zahlung nicht starten, sieht der Kunde IntaSend could not start the payment: mit dem Grund von IntaSend oder IntaSend is temporarily unavailable. Please try again in a moment or choose another payment method. Die Details werden im Protokoll festgehalten.

Die Zahlungsmethode funktioniert in der klassischen Kasse, im Kassen-Block und auf der Seite Pay for order. Sie ist mit WooCommerce High-Performance Order Storage (HPOS) kompatibel.

Das Plugin unterstützt nur einmalige Zahlungen. Erstattungen werden von WooCommerce aus nicht an IntaSend übermittelt, und es gibt keine gespeicherten Karten, keine Abonnements und kein eingebettetes Zahlungsformular (Pop-up). Ältere Kassenlinks derselben Bestellung können bei IntaSend nicht storniert werden.

Bestellungen

Bestellstatus

Pending payment: der Kunde wurde zu IntaSend weitergeleitet und hat noch nicht bezahlt, oder IntaSend hat die Zahlung noch nicht bestätigt.

Processing or Completed: die Zahlung wurde bestätigt. WooCommerce setzt den üblichen Status für eine bezahlte Bestellung. Die Bestellnotiz zeigt die IntaSend-Rechnung, die Zahlungsmethode bei IntaSend, den Betrag, den Modus (Sandbox oder Live) und wie die Zahlung bestätigt wurde (Webhook oder Rückkehr des Kunden). Die Transaktions-ID ist die Rechnungs-ID von IntaSend.

On hold: IntaSend hat einen anderen Betrag oder eine andere Währung als den Bestellbetrag gemeldet, eine Teilzahlung oder eine Zahlung, die nach der Stornierung der Bestellung einging. Die Bestellnotiz erklärt dies. Prüfen Sie die Zahlung im IntaSend-Dashboard und führen Sie die Bestellung aus oder erstatten Sie die Zahlung.

Failed: der letzte Zahlungsversuch ist fehlgeschlagen. Die Notiz zeigt den Grund von IntaSend. Der Kunde kann es erneut versuchen.

Geht eine zweite Zahlung für eine bereits bezahlte Bestellung ein, wird die Bestellung nicht erneut geändert. Eine Notiz fordert Sie auf, die Zahlung im IntaSend-Dashboard zu erstatten, falls es sich um ein Duplikat handelt. Eine Zahlung für eine erstattete Bestellung fügt eine Notiz hinzu und öffnet die Bestellung nicht wieder.

Erstattungen

Erstattungen werden von WooCommerce aus nicht an IntaSend übermittelt. Erstatten Sie die Zahlung im IntaSend-Dashboard und erfassen Sie die Erstattung manuell in WooCommerce.

Lizenzschlüssel

Das Plugin funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Payments > IntaSend. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Der Block zeigt den Status, zum Beispiel das Datum, bis zu dem die Lizenz aktiv ist, sowie Ihre Domain. Mit Check now prüfen Sie den Status erneut, mit Change key geben Sie einen anderen Schlüssel ein und mit Remove key entfernen Sie ihn von dieser Website. Der Link Manage licenses and domains in your account öffnet Ihr vibefox.net-Konto.

Ein Schlüssel funktioniert für eine Domain. Das Entfernen des Schlüssels von einer Website gibt den Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird IntaSend Kunden an der Kasse nicht angezeigt. Wird trotzdem eine Zahlung gestartet, sieht der Kunde This payment method is not available. Please choose another one. Angemeldete Shop-Manager sehen die Zahlungsmethode weiterhin, markiert mit (unlicensed — visible to admins only), damit Sie das Plugin einrichten und testen können, bevor Sie einen Schlüssel kaufen. Auf der Seite Plugins und auf WooCommerce-Seiten erscheint eine Erinnerung. Bestehende Bestellungen sind nicht betroffen: bereits gestartete Zahlungen werden weiterhin bestätigt.

Läuft eine Lizenz ab, arbeitet das Plugin weiter, für Updates und Support ist jedoch eine Verlängerung nötig. Der Status wird automatisch im Hintergrund erneut geprüft.

Fehlerbehebung

IntaSend erscheint nicht an der Kasse: prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und die Schlüssel des aktuellen Modus ausgefüllt sind und zu diesem Modus gehören: Sandbox-Schlüssel (mit _test) im Testmodus, Live-Schlüssel (mit _live) im Live-Modus. Die Shop-Währung muss unterstützt werden. Das Statusfeld oben auf der Einstellungsseite zeigt, was nicht stimmt.

Die Zahlung ist erfolgt, aber die Bestellung bleibt auf Pending payment: M-Pesa-Bestätigungen können einen Moment dauern. Der Webhook bestätigt die Bestellung, sobald IntaSend den endgültigen Status meldet. Prüfen Sie, ob die Webhook-URL im IntaSend-Dashboard (Sandbox oder Live, je nachdem, welchen Modus Sie nutzen) genau der URL in den Einstellungen entspricht und ob die Challenge dort mit Webhook challenge übereinstimmt.

Webhook antwortet Ignored: webhook challenge not configured: Webhook challenge ist leer. Geben Sie die Challenge aus dem IntaSend-Dashboard ein.

Webhook antwortet Invalid challenge: die Challenge bei IntaSend und im Plugin unterscheiden sich.

Webhook antwortet Verification unavailable, retry later oder Busy, retry later: IntaSend war in diesem Moment nicht erreichbar, oder die Bestellung wurde gerade durch eine andere Anfrage bestätigt. IntaSend wiederholt den Webhook.

Webhook antwortet Invoice not verified oder Invoice does not match the reference: IntaSend hat nicht bestätigt, dass diese Rechnung zur Bestellung gehört. Die Bestellung wird nicht geändert.

Die Bestellung ist On hold: lesen Sie die Bestellnotiz. Der bezahlte Betrag oder die Währung wich von der Bestellung ab, die Zahlung war teilweise oder sie kam, nachdem die Bestellung storniert worden war. Prüfen Sie die Zahlung im IntaSend-Dashboard.

Der Kunde sieht beim Aufgeben der Bestellung einen Fehler: aktivieren Sie das Debug log und sehen Sie unter WooCommerce > Status > Logs in der Quelle wcp_intasend_pay nach. Der Bestellbetrag muss größer als null sein. Steht im Protokoll, dass die Rückkehr-URL Zeichen enthält, die IntaSend nicht akzeptiert, liegt die Ursache in der Shop-Adresse oder in einem Sprachparameter darin.

Der Lizenzblock zeigt einen Fehler: folgen Sie der Meldung im Block. Ist der Schlüssel zum Beispiel bereits auf einer anderen Domain verwendet, geben Sie in Ihrem vibefox.net-Konto einen Platz frei und klicken Sie auf Check now. Hat sich die Adresse der Website geändert, klicken Sie auf Check now, um den Schlüssel für die neue Domain zu aktivieren. Ist der Lizenzserver nicht erreichbar, arbeitet das Plugin mit dem zuletzt bekannten Status weiter.

Deinstallation

Das Deaktivieren des Plugins behält alle Daten. Zum Entfernen deaktivieren und löschen Sie es auf der Seite Plugins. Lizenzschlüssel und Lizenzstatus dieses Plugins werden immer entfernt. Die Gateway-Einstellungen und die Protokolle werden nur entfernt, wenn Delete data on uninstall aktiviert war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Bestehende Bestellungen behalten ihre Zahlungsnotizen und Transaktions-IDs.

IntaSend ist eine Marke ihres jeweiligen Inhabers. Dieses Plugin ist nicht mit IntaSend verbunden und wird nicht von IntaSend empfohlen.