merchantSignature
HMAC-MD5 · Signatur verifiziert
Zahlung erfasst · bereit zum Abgleich
Verfügbare Integration · WayForPay
WayForPay-Zahlungen in einem Journal im Blick
Verfügbar
Das CRM prüft jedes Zahlungsergebnis, benachrichtigt Ihr Team und verknüpft die Zahlung mit einer bestehenden Bestellung. Ohne Treffer bleibt sie in einer übersichtlichen Abgleichwarteschlange.
So funktioniert es
Zahlungs-Callback
WayForPay sendet Zahlungsdaten und merchantSignature an die eindeutige Service-URL Ihrer Integration.
Zahlungsdatensatz
Eine erfolgreiche Zahlung wird einer bestehenden orderReference zugeordnet oder zum Abgleich separat gespeichert.
Keine Duplikate
Ein wiederholtes Ereignis aktualisiert dieselbe Zahlung, löst die Benachrichtigung nicht erneut aus und erfindet nie eine Bestellung.
Signaturprüfung
- Algorithmus
- HMAC-MD5 über Bestellfelder
- Feld
- merchantSignature
- merchantAccount
- wird von WayForPay gesendet und ist in der Signatur enthalten; wird vom CRM nicht separat gespeichert
- Kartendaten
- PAN, recToken, repayUrl und Signatur werden nicht gespeichert
Sicherheit
- merchantSignature wird geprüft, bevor eine Zahlung erfasst wird
- SecretKey prüft eingehende Signaturen und signiert die Accept-Antwort; er wird in der Oberfläche nie zurückgegeben
- Idempotente Erfassung und Zuordnung über orderReference
- Erzeugung signierter Test-Payloads
Einrichtung
- 01
WayForPay-Adapter hinzufügen
Geben Sie nur den SecretKey an und erstellen Sie den Adapter – Callbacks funktionieren sofort. Die Service-URL erscheint auf der Adapterseite, ebenso die Stelle, an der Sie Ihren merchantAccount und die Domain Ihrer Website hinterlegen: Damit können Sie Zahlungslinks direkt aus einer Bestellung erzeugen, und sie dienen der optionalen lokalen Signaturprüfung.
- 02
Service-URL eintragen
Bei API-Zahlungen übergeben Sie serviceUrl in Purchase oder wayforpay.run(...). Im Portal: Payment tools → Payment Button → Advanced settings → Service URL.
- 03
Kontrollzahlung durchführen
Optional können Sie als Diagnose ein lokales Beispiel erzeugen; es aktiviert die Integration nicht. Eine Kontrollzahlung prüft Ihre eigene Einrichtung im WayForPay-Portal und erscheint unter Commerce → Zahlungen oder in der bestehenden Bestellung.
Häufig gestellte Fragen
- Worin unterscheidet sich WayForPay von LiqPay?
- WayForPay verwendet HMAC-MD5 über einen eigenen Feldsatz, einschließlich merchantAccount. Das ist ein anbieterspezifischer Vertrag, nicht der Signaturablauf von LiqPay.
- Kann ich ohne echte Zahlung testen?
- Ja. Sie können SecretKey und Signatur lokal prüfen, ohne eine Zahlung zu erfassen. Das ist optional: Korrekt signierte Ereignisse werden unmittelbar nach dem Erstellen akzeptiert. Eine echte Zahlung oder eine Testzahlung des Anbieters prüft die Zustellung an die Service-URL, die Erfassung der Zahlung und die signierte Accept-Antwort.
- Muss die Bestellung bereits im CRM vorhanden sein?
- Nein. Existiert die Bestellung bereits, übergeben Sie ihre externalId als orderReference, und die Zahlung wird ihr zugeordnet. Andernfalls wird die Zahlung zum Abgleich separat gespeichert und erzeugt nicht automatisch eine Bestellung.
- Kann ich einen Zahlungslink direkt aus dem CRM erzeugen?
- Ja, sobald merchantAccount und Website-Domain auf der Adapterseite gespeichert sind: Die Schaltfläche „Zahlungslink“ an einer Bestellung oder Rechnung erzeugt dann eine WayForPay-Rechnung und liefert einen Link, den der Manager dem Käufer senden kann. Links bleiben einen Tag lang zahlbar, und die Zahlung ordnet sich selbst zu. Eine Besonderheit von WayForPay: Nach der Zahlung bleibt der Käufer auf der Ergebnisseite des Anbieters – die Methode zum Erstellen von Rechnungen akzeptiert keine Rücksprungadresse.
- Kann das CRM eine Rückerstattung auslösen oder eine Reservierung abschließen?
- Nein. Die Integration empfängt nur das Ereignis der Service-URL und gibt eine signierte Accept-Antwort zurück. Refund, Settle, Charge, Rechnungen und Payment Widget verbleiben in WayForPay oder Ihrem Shop.
WayForPay verbinden
Verfolgen Sie WayForPay-Zahlungen in einem Journal und gleichen Sie sie mit Bestellungen ab.