paydirekt ist das Online-Bezahlverfahren der deutschen Banken und Sparkassen.

Dem Online-Handel bietet es zahlreiche Vorteile. Die Kosten für Bonitätsprüfung, Mahn- und Inkassowesen, manuelle Nachbearbeitung oder Zahlungsausfälle können durch die Nutzung von paydirekt reduziert werden. Händler erhalten eine unmittelbare Zahlungsgarantie und Käuferauthentifikation. Zudem unterliegt paydirekt den strengen Regularien des deutschen Bankwesens – so auch beim Datenschutz.

Mit dem Prinzip des Bezahlens über das eigene Girokonto entspricht paydirekt den wichtigsten Verbraucherwünschen nach Sicherheit, einfacher Nutzung und Transparenz – ohne Einschaltung externer Dritter.

Inhalt

1 Funktionsweise

2 Integration

 

1 Funktionsweise

Die Zahlungsart paydirekt steht Käufern mit einem Konto teilnehmender deutscher Banken zur Verfügung und kann für Zahlungen bis 50.000,- EUR verwendet werden.

Schematischer Ablauf einer Bestellung mit der Zahlungsart paydirekt:

Der Käufer wählt auf der Zahlungs- und Versandarten-Seite (ws_pay_deliv.htm) die Zahlungsart paydirekt aus und bestätigt seinen Kauf auf der Bestellübersichtsseite (ws_place_order.htm).

Nun gelangt der Käufer auf die paydirekt-Seite, wo er sich mit seinen Nutzerdaten einloggt und die angezeigten Bestell-Details bestätigt (oder sich zuvor für paydirekt registriert).

paydirekt stellt nun eine Anfrage zur Zahlungsautorisierung an die Bank des Käufers. Nach erfolgter Autorisierung der Zahlung durch die Bank des Käufers erhält der Händler die Zahlungsgarantie und Käufer die Kaufbestätigung.

Der Bestellvorgang im Shop ist damit abgeschlossen und dem Käufer wird die HTML-Bestelleingangsbestätigungsseite (ws_confirm.htm) angezeigt.

paydirekt stellt nun die Daten zur Abwicklung des Zahlungsverkehrs der Käufer- und Händlerbank bereit. Die Händlerbank reicht auf dem Konto des Händlers die paydirekt-Zahlung ein.

 

2 Integration

Schritt 1: Voraussetzungen

Um die Zahlungsart paydirekt in Ihrem Shop anzubieten, ist zunächst ein Vertrag mit paydirekt abzuschließen. Bitte wenden Sie sich diesbezüglich direkt an paydirekt.

Ferner muss der Händler über ein Geschäftskonto bei einer der teilnehmenden Banken und Sparkassen in Deutschland verfügen.

Schritt 2: Freischaltung/Aktivierung durch WEBSALE

Die Zahlungsart paydirekt muss bei WEBSALE freigeschaltet werden. Hierzu werden folgende Informationen benötigt, die Sie von paydirekt erhalten:

APIKey

APISecret


Hinweis:

Es gibt die Möglichkeit, die Zahlungsart mittels Sandbox-Modus von paydirekt zu testen. Für diesen Sandbox-Modus ist ein eigener Account nötig, der bei paydirekt beantragt werden muss. Dabei erhalten Sie gesonderte Authentifizierungsdaten (APIKey und APISecret).

Bitte teilen Sie uns APIKey und APISecret des Sandbox-Modus mit, damit wir die Anbindung an den Sandbox-Modus korrekt für Sie einrichten können.

Ihr WEBSALE Ansprechpartner steht Ihnen gerne auch bei Fragen zur Verfügung.

Schritt 3: Zahlungsart in der Shopkonfiguration shop.config ergänzen

Fügen Sie der Shopkonfiguration shop.config den neuen Abschnitt <PaymentPaydirekt-Txt> mit den folgenden Parametern hinzu:

<PaymentPaydirekt-Txt>
   Allow                = yes
   TestMode             = yes
   Name                 = paydirekt
   NameSuffix           = paydirekt ist das Online-Bezahlverfahren der deutschen Banken und Sparkassen: sicher. einfach. direkt.
   ImgOnClick           = selectPaymentImage('~ID~');
   RadioOnClick         = selectPayment('~ID~');
   Img                  = <logo-XYZ.png>
   DelivererID-List     = <Ihre Versandarten-IDs>
   ...
   MaxTotal-Value                          = 50000
   CapturingMode                           = auto
   PaydirektLineItemAdditionName           = Zuschlag
   PaydirektLineItemAdditionNumber         = 111111
   PaydirektLineItemReductionName          = Rabatt
   PaydirektLineItemReductionNumber        = 222222
   ...
</PaymentPaydirekt-Txt>

Referenz: Abschnitt PaymentPaydirekt-Txt


Hinweis:

Bei den Parametern PaydirektLineItemAdditionNumber und PaydirektLineItemReductionNumber müssen sogenannte Pseudo-Produktnummern hinterlegt werden. Dabei ist zu beachten, dass diese nicht aus dem Nummernkreis der im Shop angebotenen Produkte stammen. Die Auswahl der Pseudo-Produktnummern sollte daher mit dem Händler oder dem Verantwortlichen bei der WaWi abgesprochen werden.

Die für alle Zahlungsarten möglichen Standard-Parameter finden Sie unter:

Referenz: Abschnitt PaymentXXX-Txt

Schritt 4: Hinweismeldung definieren

Definieren Sie in der Shopkonfiguration shop.config im Abschnitt <NotifyMessages-Txt> folgende Hinweismeldungen:

<NotifyMessages-Txt>
   ...
   Paydirekt-ClearingError     = Der Bezahlvorgang mit paydirekt konnte leider nicht abgeschlossen werden. Bitte wählen Sie eine andere Zahlungsart.
   Paydirekt-ClearingCancel    = Sie haben den Bezahlvorgang mit paydirekt abgebrochen.
   ...
</NotifyMessages-Txt>

Referenz: Abschnitt NotifyMessages-Txt

Schritt 5: Testen der Zahlungsart

Um die Zahlungsart paydirekt in Ihrem Shop zu testen, stellt Ihnen WEBSALE einen speziellen Zahlungsarten-Testmodus zur Verfügung. Die Zahlungsart ist nur im Testmodus sichtbar; der Produktivbetrieb Ihres Shops wird dadurch nicht beeinflusst.

Achten Sie darauf, dass der Parameter TestMode im Abschnitt <PaymentPaydirekt-Txt> Ihrer Shopkonfiguration shop.config auf yes steht.

Hängen Sie zum Aktivieren des Zahlungsarten-Testmodus an einen beliebigen Shop-Aufruf (der Shop muss sich bereits im allgemeinen Testmodus befinden) den Parameter &payment-test=on an.

Beispiel:

http://www.xyz.de/?test=on&payment-test=on

Wegweiser: Testmodi des Shops ein-/ausschalten

Im Template kann hierbei durch das Tag ST-PaymentTest ein Hinweis angezeigt werden, wenn der Shop im Zahlungsarten-Testmodus aufgerufen wurde:

{ST-PaymentTest}
   Zahlungsarten-Testmodus an
{/ST-PaymentTest}

Referenz: ST-PaymentTest

Hängen Sie nach erfolgreich abgeschlossenem Test zum Deaktivieren des Zahlungsarten-Testmodus an einen beliebigen Shop-Aufruf den Parameter &payment-test=off an.

Beispiel:

http://www.xyz.de/?test=on&payment-test=off

Schritt 6: Zahlungsart paydirekt für den Produktivbetrieb aktivieren

Setzen Sie im Abschnitt <PaymentPaydirekt-Txt> der Shopkonfiguration shop.config den Parameter TestMode auf no und achten Sie darauf, dass der Parameter Allow auf yes steht.

<PaymentPaydirekt-Txt>
   Allow                        = yes
   TestMode                     = no
   ...
</PaymentPaydirekt-Txt>

Referenz: Abschnitt PaymentPaydirekt-Txt


Hinweis:

Wenn Sie die Testmöglichkeit mittels Sandbox-Modus von paydirekt genutzt haben, teilen Sie uns bitte mit, wenn Sie die Umstellung auf den Produktivbetrieb wünschen.

WEBSALE richtet dann die Produktiv-Anbindung an paydirekt ein (mittels APIKey und APISecret des Produktiv-Accounts).

Haben Sie alle Schritte durchgeführt, ist die Zahlungsart paydirekt erfolgreich in Ihrem Shop integriert und aktiv.