VibeFox Adyen for PrestaShop

Übersicht

VibeFox Adyen Gateway ergänzt PrestaShop um Zahlungen über Adyen Payment Links. Im Zahlungsschritt wählt der Kunde Adyen, wird zur von Adyen gehosteten Zahlungsseite weitergeleitet, bezahlt mit jeder Methode, die in Ihrem Adyen-Händlerkonto aktiviert ist (Karten, Wallets und lokale Zahlungsmethoden), und kehrt in Ihren Shop zurück. Kartendaten gelangen nie auf Ihre Website. Die Bestellung wird erst angelegt, nachdem Adyen die Zahlung über einen signierten Webhook bestätigt hat, sodass abgebrochene Zahlungen keine unbezahlten Bestellungen hinterlassen.

Das Modul eignet sich für Shops, die ein Adyen-Händlerkonto haben und die Zahlungsmethoden dieses Kontos nutzen möchten, ohne selbst ein Zahlungsformular auf der eigenen Website aufzubauen. Das Modul bietet keine Abonnements oder wiederkehrenden Zahlungen, keine gespeicherten Karten, keine Kartenfelder auf der Website (Drop-in oder Components) und keine Schaltflächen für Erfassung oder Stornierung in PrestaShop. Die Erfassung richtet sich nach Ihren Adyen-Kontoeinstellungen.

Hauptfunktionen

Adyen Payment Links: Für den Warenkorbbetrag in der Warenkorbwährung wird ein Zahlungslink erstellt, mit den kleinsten Währungseinheiten (Minor Units), die Adyen für jede Währung erwartet (ohne Dezimalstellen, zum Beispiel JPY, KRW, IDR; mit drei Dezimalstellen, zum Beispiel KWD, BHD).

Bezahlt nur, wenn Adyen bestätigt: Die Bestellung wird nur durch den HMAC-signierten Webhook AUTHORISATION angelegt. Die Rückkehr in den Shop legt nie eine Bestellung an und bezahlt keine.

Prüfung von Betrag und Währung: Betrag und Währung, die Adyen bestätigt, werden mit dem Warenkorb verglichen. Bei einer Abweichung erhält die Bestellung den Status Adyen payment on hold und eine Notiz.

Keine doppelte Verarbeitung: wiederholte oder parallele Webhook-Zustellungen erzeugen nie eine zweite Bestellung und verbuchen die Zahlung nicht doppelt. Ein neuer Zahlungsversuch lässt den vorherigen Zahlungslink ablaufen, und eine zweite erfolgreiche Zahlung für eine bereits bezahlte Bestellung fügt eine Warnnotiz hinzu.

Test- und Live-Modus: getrennte API-Schlüssel und HMAC-Schlüssel für jede Umgebung. Erstattungen gehen immer an die Umgebung und das Händlerkonto, mit denen die Zahlung erfolgt ist.

Erstattungen aus der Bestellseite: vollständige und Teilerstattungen im Block Adyen payment der Bestellung, im Betrag und in der Währung, die Adyen belastet hat. Adyen bestätigt das Ergebnis per Webhook. Eine vollständige Erstattung setzt die Bestellung auf Refunded.

Bestellstatus nach Wahl: Payment accepted, Delivered oder Adyen payment on hold für die manuelle Prüfung nach einer erfolgreichen Zahlung.

Adyen-Block auf der Bestellseite: PSP-Referenz, Zahlungslink, Händlerkonto, Beträge und Erstattungsverlauf. Das Protokoll enthält keine API-Schlüssel und keine personenbezogenen Daten der Käufer.

Anforderungen

PrestaShop 8.0 bis 9.x, PHP 8.0 oder neuer. Ein Adyen-Händlerkonto mit API-Schlüsseln, ein Standard-Webhook mit HMAC-Schlüssel und für Live-Zahlungen das Live-URL-Präfix. Ein VibeFox-Lizenzschlüssel von vibefox.net (ein Schlüssel pro Domain).