> ## 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.

# PayU

> Wie Sie die Zahlungsart PayU in WEBSALE V8s einrichten, wie der Warenkorb an PayU übergeben wird und was beim Zwischenstand AUTHORIZE_REQUEST zu beachten ist.

PayU ist ein Online-Überweisungsverfahren. Der Käufer gibt im Shop nur an, bei welcher Bank er Kunde ist, und wird dann auf die Anmeldeseite seines eigenen Onlinebankings geleitet. Dort gibt er die Überweisung frei und kehrt anschließend in den Shop zurück.

Für den Shop bedeutet das: Es werden keine Bankdaten im Shop erfasst, und die Rückmeldung über den Ausgang der Zahlung kommt von PayU, nicht vom Käufer. Der Einrichtungsaufwand liegt deshalb nicht im Template, sondern in der Konfiguration und in der Frage, wie Ihr Shop mit einem noch offenen Zahlungsstand umgeht.

Angebunden wird PayU über Computop.

## Voraussetzungen

Nötig ist ein Vertrag mit Computop. Wenden Sie sich für die Anbindung zunächst dorthin.

Für die Freischaltung durch WEBSALE brauchen Sie anschließend drei Angaben von PayU:

* das Passwort
* die MerchantID
* den PayUKey

Ist die Zahlungsart nicht durch WEBSALE freigeschaltet, schaltet der Shop sie von sich aus wieder ab, unabhängig davon, was in `Allow` steht.

## Zahlungsart anlegen

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<PaymentPayU-Txt>
   Allow            = yes
   TestMode         = yes
   Name             = PayU
   NameSuffix       = Bezahlen Sie über Ihr gewohntes Onlinebanking.
   Img              = logo-payu.png
   RadioOnClick     = selectPayment('~ID~');
   ImgOnClick       = selectPaymentImage('~ID~');
   DelivererID-List = standard,express

   PayUArticleListAdditionName  = Zuschlag
   PayUArticleListReductionName = Rabatt
</PaymentPayU-Txt>
```

| Parameter | Bedeutung |
| - | - |
| `PayUArticleListAdditionName` | Bezeichnung der Sammelposition für Zuschläge im an PayU übergebenen Warenkorb |
| `PayUArticleListReductionName` | Bezeichnung der Sammelposition für Abschläge und Rabatte |

Die allgemeinen Parameter sind dieselben wie bei jeder anderen Zahlungsart.

Referenz: [Abschnitt PaymentPayU-Txt](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/zahlungsarten.md#paymentpayu-txt) · [Abschnitt PaymentXXX-Txt](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/zahlungsarten.md)

## Wie der Warenkorb an PayU übergeben wird

PayU bekommt den Warenkorb positionsweise, jede Position mit Name, Einzelpreis und Menge. Der Einzelpreis ist der Preis nach allen gewährten Rabatten, und er wird in der kleinsten Währungseinheit übergeben, bei Euro also in Cent.

Daraus ergeben sich zwei Dinge, die Sie bei der Einrichtung beachten sollten.

### Die Sammelposition für die Differenz

Zu- und Abschläge, die keiner einzelnen Position zuzuordnen sind, etwa Versandkosten oder ein Gutschein auf die Gesamtbestellung, lassen sich in dieser Aufstellung nicht als Korrektur abbilden. Weicht die Summe der Positionen von der Gesamtsumme ab, hängt der Shop deshalb eine zusätzliche Position mit der Menge 1 an.

Ist die Differenz positiv, trägt sie den Namen aus `PayUArticleListAdditionName`, ist sie negativ, den aus `PayUArticleListReductionName`. Beide Parameter sollten Sie deshalb setzen, sonst steht dort in der Aufstellung, die der Käufer bei PayU sieht, ein leerer Name.

### Produktnamen werden bereinigt

Computop verträgt in den Produktnamen weder Kommas noch HTML. Der Shop bereinigt die Namen deshalb vor der Übergabe automatisch:

| Was | Was daraus wird |
| - | - |
| Komma | Leerzeichen, denn das Komma trennt die Felder der Aufstellung |
| HTML-Elemente | entfernt |
| HTML-Entities wie `&#8222;` | entfernt |
| verbliebene kaufmännische Und-Zeichen | entfernt |

> [!WARNING]
>
> Produktnamen, die Auszeichnungen oder Sonderzeichen enthalten, erscheinen bei PayU deshalb anders als in Ihrem Shop. Wenn ein Name nach der Bereinigung nichts Aussagekräftiges mehr übrig lässt, sieht der Käufer bei PayU eine Position ohne verständliche Bezeichnung. Prüfen Sie Ihren Produktbestand daraufhin, bevor Sie die Zahlungsart produktiv schalten.

## Hinweismeldungen

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<NotifyMessages-Txt>
   PayU-ClearingError = Der Bezahlvorgang mit PayU konnte nicht abgeschlossen werden. Bitte wählen Sie eine andere Zahlungsart.
   PayU-ClearingDeny  = Der Bezahlvorgang mit PayU wurde abgelehnt.
</NotifyMessages-Txt>
```

Referenz: [Abschnitt NotifyMessages-Txt](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/texte-und-meldungen.md#notifymessages-txt)

## Der Zwischenstand AUTHORIZE\_REQUEST

PayU meldet den Ausgang der Zahlung nicht immer sofort. Bleibt die Rückmeldung nach der Rückleitung in den Shop für rund zehn Sekunden aus, meldet Computop den Zwischenstand `AUTHORIZE_REQUEST`. Die Bestellung gilt dann als schwebend, nicht als bezahlt und nicht als abgelehnt.

Der endgültige Stand wird anschließend gesondert nachgemeldet, ohne dass der Käufer noch beteiligt ist.

> [!WARNING]
>
> Rechnen Sie im Betrieb damit, dass Bestellungen in diesem Zwischenstand liegen bleiben. Klären Sie mit Ihrer Warenwirtschaft, wie damit umgegangen wird, bevor Sie die Zahlungsart produktiv schalten. Eine schwebende Zahlung ist kein Zahlungseingang.

Während der Rückleitung von PayU ist die Sitzung für das Online-Clearing gesperrt. Ruft der Käufer den Shop in dieser Zeit in einem zweiten Fenster auf, bekommt er die Seite aus dem Template `SessionLockedForOnlineclearing` zu sehen. Legen Sie dieses Template an, sonst steht der Käufer vor einer Standardseite.

## Auswahl im Bestellablauf

PayU erscheint zusammen mit allen anderen Zahlungsarten über `~WS-PaymentFields~` auf `ws_pay_deliv.htm`. Eigene Tags oder Template-Anpassungen braucht es nicht.

## Testen

Ein eigener Clearing-Testmodus mit eigenem URL-Parameter ist für PayU nicht vorgesehen. Es bleibt beim allgemeinen Zahlungsarten-Testmodus.

Mit `TestMode = yes` im Abschnitt `<PaymentPayU-Txt>` ist die Zahlungsart nur sichtbar, solange der Shop im Zahlungsarten-Testmodus läuft. Der Produktivbetrieb Ihres Shops bleibt davon unberührt.

```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 lässt sich der Testbetrieb anzeigen:

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{ST-PaymentTest}
   <p class="hinweis">Zahlungsarten-Testmodus aktiv</p>
{/ST-PaymentTest}
```

Zum Abschalten:

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
https://www.ihre-shop-url.de/?test=off&payment-test=off
```

> [!WARNING]
>
> Das Umschalten des Zahlungsarten-Testmodus verwirft die laufende Sitzung und damit den Warenkorb. Schalten Sie ihn deshalb vor dem Befüllen des Warenkorbs ein, nicht auf der Bestellübersicht.

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)

## Produktivbetrieb

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<PaymentPayU-Txt>
   Allow    = yes
   TestMode = no
</PaymentPayU-Txt>
```

## 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)
* Wegweiser: [Computop, für die gemeinsame Grundlage aller über Computop abgewickelten Zahlungsarten](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/computop.md)
* Wegweiser: [Versandarten anlegen, für die Kopplung über `DelivererID-List`](https://dokumentation.websale.de/v8s/versandarten-anlegen/versandarten-anlegen)


## 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)
- [Computop](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/computop.md)
- [Texte und Meldungen](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/texte-und-meldungen.md)
- [stripe](https://dokumentation.websale.de/frontend/funktionsubersicht/zahlungsarten/stripe.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.