> ## Documentation Index
> Fetch the complete documentation index at: https://dokumentation.websale.de/llms.txt
> Use this file to discover all available pages before exploring further.
# paydirekt
> Wie die Zahlungsart paydirekt in WEBSALE V8s eingerichtet wurde und was beim Betrieb bestehender Anbindungen zu beachten ist.
> [!WARNING]
>
> **Dieses Bezahlverfahren wird nicht mehr angeboten.** paydirekt ging in giropay auf, und die deutsche Kreditwirtschaft hat das gemeinsame Verfahren eingestellt. Für neue Shops kommt paydirekt nicht mehr in Frage. Diese Seite beschreibt den Stand für bestehende Anbindungen. Wenn Sie eine Alternative suchen, sprechen Sie mit Ihrem WEBSALE-Ansprechpartner.
paydirekt war das Online-Bezahlverfahren der deutschen Banken und Sparkassen. Der Käufer zahlte direkt von seinem Girokonto, ohne dass ein externer Anbieter dazwischenstand, und der Händler bekam mit der Autorisierung eine Zahlungsgarantie.
## Wie der Bezahlvorgang ablief
1. Der Käufer wählte paydirekt auf der Zahlungs- und Versandartenseite und bestätigte auf der Bestellübersicht.
2. Der Shop leitete ihn zu paydirekt weiter. Dort meldete er sich an oder registrierte sich.
3. paydirekt fragte die Autorisierung bei seiner Bank an. Nach der Freigabe erhielt der Händler die Zahlungsgarantie.
4. Der Käufer kam zurück in den Shop und sah die Bestelleingangsbestätigung `ws_confirm.htm`.
Das Verfahren stand nur Käufern mit einem Konto bei einer teilnehmenden deutschen Bank offen, und der Höchstbetrag lag bei 50.000 Euro.
## Voraussetzungen
Nötig waren ein Vertrag mit paydirekt und ein Geschäftskonto bei einer teilnehmenden deutschen Bank oder Sparkasse.
Für die Freischaltung durch WEBSALE brauchte es zwei Angaben von paydirekt:
* den APIKey
* das APISecret
Zum Testen gab es einen Sandbox-Betrieb mit eigenem Zugang und eigenen Zugangsdaten. Wer ihn genutzt hatte, musste WEBSALE die Umstellung auf den Produktivbetrieb ausdrücklich melden, damit dort die produktiven Zugangsdaten eingetragen wurden.
## Zahlungsart anlegen
```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
Allow = yes
TestMode = yes
Name = paydirekt
NameSuffix = Das Online-Bezahlverfahren der deutschen Banken und Sparkassen.
Img = logo-paydirekt.png
RadioOnClick = selectPayment('~ID~');
ImgOnClick = selectPaymentImage('~ID~');
DelivererID-List = standard,express
MaxTotal-Value = 50000
CapturingMode = auto
PaydirektLineItemAdditionName = Zuschlag
PaydirektLineItemAdditionNumber = 111111
PaydirektLineItemReductionName = Rabatt
PaydirektLineItemReductionNumber = 222222
```
| Parameter | Bedeutung |
| - | - |
| `MaxTotal-Value` | Höchstbetrag der Gesamtsumme, bei paydirekt 50.000 Euro |
| `CapturingMode` | `auto` bucht sofort ab, `manual` reserviert nur und überlässt die Buchung Ihnen |
| `PaydirektLineItemAdditionName` | Bezeichnung der Sammelposition für Zuschläge |
| `PaydirektLineItemAdditionNumber` | Produktnummer dieser Sammelposition |
| `PaydirektLineItemReductionName` | Bezeichnung der Sammelposition für Rabatte |
| `PaydirektLineItemReductionNumber` | Produktnummer dieser Sammelposition |
paydirekt bekam den Warenkorb positionsweise übergeben. Zu- und Abschläge ließen sich dort nicht als Korrektur abbilden, sie gingen deshalb als eigene Positionen mit. Die vier Parameter geben diesen beiden Positionen ihren Namen und ihre Nummer.
> [!WARNING]
>
> Die beiden Nummern sind Pseudo-Produktnummern und dürfen **nicht** aus dem Nummernkreis Ihrer echten Produkte stammen. Andernfalls kollidieren sie in der Warenwirtschaft mit einem tatsächlichen Artikel. Stimmen Sie die Wahl mit dem Verantwortlichen für die Warenwirtschaft ab.
Ist die Zahlungsart nicht durch WEBSALE freigeschaltet, schaltet der Shop sie von sich aus wieder ab, unabhängig davon, was in `Allow` steht.
Referenz: [Abschnitt PaymentPaydirekt-Txt](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/zahlungsarten.md#paymentpaydirekt-txt) · [Abschnitt PaymentXXX-Txt](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/zahlungsarten.md)
## Hinweismeldungen
```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
Paydirekt-ClearingError = Der Bezahlvorgang mit paydirekt konnte nicht abgeschlossen werden. Bitte wählen Sie eine andere Zahlungsart.
Paydirekt-ClearingCancel = Sie haben den Bezahlvorgang mit paydirekt abgebrochen.
```
Referenz: [Abschnitt NotifyMessages-Txt](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/texte-und-meldungen.md#notifymessages-txt)
## Auswahl im Bestellablauf
paydirekt erschien zusammen mit allen anderen Zahlungsarten über `~WS-PaymentFields~` auf `ws_pay_deliv.htm`. Eigene Tags oder Template-Anpassungen brauchte es nicht.
## Testen
Ein eigener Clearing-Testmodus mit eigenem URL-Parameter war für paydirekt nicht vorgesehen. Es blieb beim allgemeinen Zahlungsarten-Testmodus.
Mit `TestMode = yes` im Abschnitt `` war die Zahlungsart nur sichtbar, solange der Shop im Zahlungsarten-Testmodus lief.
```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
https://www.ihre-shop-url.de/?test=on&payment-test=on
```
Im Template ließ sich der Testbetrieb anzeigen:
```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{ST-PaymentTest}
Zahlungsarten-Testmodus aktiv
{/ST-PaymentTest}
```
Wegweiser: [Testmodi des Shops ein- und ausschalten](https://dokumentation.websale.de/v8s/domains/testmodi-des-shops-ein-ausschalten.md) · Referenz: [ST-PaymentTest](https://dokumentation.websale.de/v8s/referenz/tags/st/seitenzustand-und-navigation.md)
## Verwandte Themen
* Wegweiser: [Zahlungsarten anlegen, für die allgemeinen Parameter und die Ausgabe im Template](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/zahlungsarten-anlegen.md)
## Related topics
- [Zahlungsarten](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/zahlungsarten.md)
- [Zahlungsarten-Codes](https://dokumentation.websale.de/v8s/materialien/zahlungsarten-codes.md)
- [Texte und Meldungen](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/texte-und-meldungen.md)
- [Sektionen: Kopfdaten und Adressen](https://dokumentation.websale.de/v8s/schnittstellen/bestellungen/ws-bestelldaten/sektionen-kopf-und-adressen.md)
- [Konfiguration-Migration](https://dokumentation.websale.de/migration/migration-websale-v8s-neue-version/konfiguration-migration.md)
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.