Zahlungs-Gateway-Fehlerbehebung – wenn eine Zahlung nicht bestätigt wird

Zahlungen gehen direkt von Ihrem Kunden auf Ihr eigenes Gateway-Konto. Ihr Gateway meldet Ihrem Shop dann, dass die Zahlung durchgegangen ist, und der Shop liefert die Bestellung aus. Wenn ein Kunde sagt „Ich habe bezahlt, aber nichts bekommen“, ist meist eines dieser Glieder unterbrochen. Gehen Sie die Schritte der Reihe nach durch.

1Step 1 of 8Zahlung finden

Gehen Sie zu Invoices → Payment logs. Die Seite Payment Logs listet jede Zahlung mit Betrag, Gateway und Kunde auf. Filtern Sie mit Paid, Pending und Failed oder suchen Sie nach dem Kunden. Klicken Sie auf eine Zahlung, um ihre Details zu sehen.

• Paid: Die Zahlung ist bestätigt. Hat der Kunde trotzdem nichts erhalten, liegt das Problem bei der Auslieferung, nicht bei der Zahlung. Siehe Häufige Probleme beheben.
• Pending: Der Kunde hat den Checkout begonnen, aber das Gateway hat keine Zahlung bestätigt. Machen Sie mit Schritt 2 weiter.
• Failed: Die Zahlung ist nicht durchgegangen, oder der Checkout wurde geschlossen, weil nicht rechtzeitig eine Zahlung bestätigt wurde.

2Step 2 of 8Status des Gateways prüfen

Gehen Sie zu Payment gateways. Unter Configured Gateways zeigt jedes Gateway Active, Inactive oder Misconfigured an.

• Inactive: Das Gateway ist ausgeschaltet, und Kunden können damit nicht bezahlen. Klicken Sie auf Configure, schalten Sie Gateway Status ein und klicken Sie auf Save Changes.
• Misconfigured: Unsere regelmäßige Prüfung hat ergeben, dass das Gateway seine Schlüssel abgelehnt hat. Der Grund steht unter dem Gateway, zusammen mit Last checked: und der Uhrzeit. Ein falsch konfiguriertes Gateway wird im Checkout nicht angeboten, bis Sie seine Schlüssel korrigieren (Schritt 3).

3Step 3 of 8Schlüssel aktualisieren

Klicken Sie beim Gateway auf Configure. Fügen Sie den neuen Schlüssel bzw. das neue Secret aus dem Dashboard Ihres Gateways in das passende Feld ein. Bereits gespeicherte Secret-Felder zeigen Leave empty to keep existing value (leer lassen, um den bestehenden Wert zu behalten), Sie füllen also nur aus, was sich ändert. Klicken Sie auf Save Changes.

Bei manchen Gateways werden die Schlüssel beim Speichern direkt beim Gateway geprüft. Lehnt das Gateway sie ab, sehen Sie die Begründung, und es wird nichts gespeichert. Sobald die neuen Schlüssel gespeichert sind, wird das Gateway im Checkout wieder angeboten.

Verwenden Sie für echte Kunden Live-Schlüssel, keine Test- oder Sandbox-Schlüssel.

4Step 4 of 8Webhook prüfen

Manche Gateways informieren Ihren Shop nur per Webhook über eine Zahlung. Bei diesen zeigt die Seite Configure einen Kasten Webhook setup — required for automatic confirmation mit der zu verwendenden Adresse.

Klicken Sie auf Copy und tragen Sie genau diese Adresse im Dashboard Ihres Gateways ein. Schon ein fehlendes oder zusätzliches Zeichen, etwa ein Schrägstrich am Ende, verhindert, dass Zahlungen bestätigt werden. Fügen Sie dann den Schlüssel, den Ihnen das Gateway gibt, in das Feld ein, das im Kasten genannt wird, und klicken Sie auf Save Changes.

Ohne den Webhook können bezahlte Bestellungen im Status „ausstehend“ hängen bleiben.

5Step 5 of 8Eine eingegangene Zahlung bestätigen

Prüfen Sie zuerst das Dashboard Ihres Gateways. Machen Sie nur weiter, wenn das Geld wirklich auf Ihrem Konto ist.

Gehen Sie zu Customers → All customers, öffnen Sie den Kunden und dann den Tab Orders, und klicken Sie auf die Bestellung. Unter Order Details zeigt eine ausstehende Bestellung Awaiting Payment (oder Order Abandoned, wenn sie älter ist). Eine Bestellung, die geschlossen wurde, weil das Gateway sie nie bestätigt hat, zeigt Closed — no payment received in time.

Klicken Sie auf Confirm payment. Fügen Sie unter Payment reference (optional) die Bestell- oder Transaktions-ID aus Ihrem Gateway ein, damit sich die Zahlung später nachverfolgen lässt. Klicken Sie auf Mark paid & provision. Die Bestellung wird als bezahlt markiert und ausgeliefert, als hätte das Gateway sie bestätigt.

Hinweis: Eine Bestellung, die das Gateway selbst abgelehnt oder erstattet hat, hat keinen Button Confirm payment.

6Step 6 of 8Oder einen neuen Zahlungslink senden

Hat der Kunde die Zahlung nicht abgeschlossen und haben Sie das Modul Pay-by-Link, klicken Sie bei der ausstehenden Bestellung auf Copy payment link und senden Sie ihm den Link. Damit bezahlt er genau diese Bestellung, und die Zahlung wird wie gewohnt bestätigt.

7Step 7 of 8Wenn ein Checkout nicht starten konnte

Manchmal lehnt das Gateway schon den Start der Zahlung ab, sodass der Kunde die Zahlungsseite nie erreicht. Ihr Kunde sieht dann "This payment method isn't available right now" (diese Zahlungsmethode ist gerade nicht verfügbar) und kann eine andere Methode wählen. Es wird nichts abgebucht.

Den Grund erfahren Sie an drei Stellen:

• Ihre Benachrichtigungsglocke: eine Meldung pro Gateway und Grund pro Tag. Tippen Sie darauf, um Payment gateways zu öffnen.
• Payment gateways: Unter dem Gateway zeigt ein Kasten Checkout problem, was passiert ist, was das Gateway geantwortet hat und What to do (was zu tun ist). Er verschwindet von selbst nach dem nächsten Checkout, der ohne Problem startet.
• Ihr eigener Test-Checkout: Wenn Sie Ihren Shop testen und dabei mit einem Kundenkonto angemeldet sind, das dasselbe E-Mail-Postfach wie Ihre Shop-Anmeldung nutzt (zum Beispiel you+test@…), zeigt der Checkout denselben Kasten. Ihre Kunden sehen ihn nie.

Die häufigsten Antworten:

• WolvPay: "No enabled wallets found": In Ihrem WolvPay-Konto ist keine Wallet aktiviert, auf der die Coins eingehen können. Fügen Sie in WolvPay eine Wallet mit Ihrer Empfangsadresse hinzu und aktivieren Sie sie.
• Rampex: "Merchant custom wallet not configured": Ihr Rampex-Konto hat keine Auszahlungs-Wallet. Richten Sie in Rampex Ihre Auszahlungs-Wallet ein.
• Unauthorized oder ungültiger Schlüssel: Der Schlüssel ist falsch, wurde geändert oder ist ein Testschlüssel. Kopieren Sie Ihren Live-Schlüssel erneut, klicken Sie dann unter Payment gateways auf Configure, fügen Sie ihn ein und klicken Sie auf Save Changes. Wo Configure kein Schlüsselfeld zeigt (Rampex, Mollie, SumUp und einige andere), klicken Sie auf Add Gateway, fügen Sie das Gateway mit dem neuen Schlüssel erneut hinzu und schalten Sie das alte dann mit Gateway Status aus.
• Ihr Konto kann keine Live-Zahlungen annehmen: Das Gateway-Konto ist noch nicht aktiviert oder eingeschränkt. Erledigen Sie, was das Dashboard Ihres Gateways verlangt.
• Währung nicht unterstützt: Ihr Gateway-Konto akzeptiert diese Währung nicht. Aktivieren Sie sie in Ihrem Gateway-Konto oder verkaufen Sie in einer Währung, die es akzeptiert.
• Betrag zu klein: Die Summe liegt unter dem Mindestbetrag des Gateways, was bei Testpreisen von €1 oft vorkommt. Testen Sie mit einem Preis über dem Mindestbetrag.
• Square: Location ID: Die Location ID stammt nicht aus demselben Square-Konto wie das Access Token. Kopieren Sie die Location ID aus derselben Square-App, fügen Sie sie unter Configure ein und klicken Sie auf Save Changes.
• Keine Antwort oder Zeitüberschreitung: ein vorübergehendes Problem auf der Seite des Gateways. Sie müssen nichts korrigieren; versuchen Sie es in ein paar Minuten erneut.

Nach der Korrektur prüfen Sie es mit einem Test-Checkout in Ihrem Shop (Fixed it? Run a test checkout).

Wenn Sie ein Gateway hinzufügen und es die Angaben ablehnt, zeigt das Formular Not saved — the gateway refused these details mit derselben Erklärung. Korrigieren Sie, was dort steht, und klicken Sie erneut auf Add Gateway.

8Step 8 of 8Wenn Zahlungsbestätigungen abgelehnt werden (Webhook-Secret)

WolvPay, Rampex und Square signieren jedes Zahlungs-Update, das sie an Ihren Shop senden, mit dem Webhook-Secret aus Ihrem Gateway-Konto. Stimmt das in Ihrem Shop gespeicherte Secret nicht damit überein, müssen wir diese Updates ablehnen, und Zahlungen werden nicht sofort bei Eingang bestätigt. Verloren sind sie nicht: Wir fragen das Gateway außerdem regelmäßig nach offenen Zahlungen (WolvPay und Rampex alle 10 Minuten, Square stündlich), sodass bezahlte Bestellungen trotzdem bestätigt werden, nur später.

Wenn das wiederholt passiert, sehen Sie es an drei Stellen:

• Ihr Dashboard: eine Meldung mit dem Namen des Gateways und See how to fix it.
• Payment gateways: unter dem Gateway ein Kasten Payment confirmations mit der Anzahl abgelehnter Updates und What to do.
• Ihre Benachrichtigungsglocke: eine Meldung, bis das Problem behoben ist. Tippen Sie darauf, um Payment gateways zu öffnen.

So beheben Sie es:

• WolvPay: Öffnen Sie in Ihrem WolvPay-Dashboard die Webhook-Einstellungen und kopieren Sie das Webhook-Secret. Klicken Sie unter Payment gateways bei Ihrem WolvPay-Gateway auf Configure, löschen Sie den Inhalt des Feldes Webhook Secret, fügen Sie das Secret ein und klicken Sie auf Save Changes.
• Square: Öffnen Sie in der Square Developer Console das Webhook-Abonnement Ihrer Anwendung und kopieren Sie dessen Signature Key. Prüfen Sie, dass die Benachrichtigungs-URL genau https://iptvbp.com/api/webhooks/square lautet. Klicken Sie unter Payment gateways bei Ihrem Square-Gateway auf Configure, löschen Sie den Inhalt des Feldes Webhook Signature Key, fügen Sie den Key ein und klicken Sie auf Save Changes.
• Rampex und Cash App Pay: Bei diesen hat Configure kein Secret-Feld. Klicken Sie auf Add Gateway, fügen Sie das Gateway mit dem Secret im Feld Webhook Secret (Rampex) bzw. Webhook Signature Key (Cash App Pay) erneut hinzu und schalten Sie das alte dann mit Gateway Status aus.

Die Meldung verschwindet von selbst, sobald das nächste Zahlungs-Update des Gateways die Prüfung besteht. Das Secret selbst zeigen oder versenden wir nie.