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

# Ratenkauf

> Die Zahlungsart Ratenkauf in WEBSALE V8s: Abschnitt PaymentInstallment-Txt, die Behandlung der Zinsen als Zahlungskosten und die Hinweismeldungen.

Beim Ratenkauf finanziert ein Kreditinstitut den Kaufbetrag und der Käufer zahlt ihn in Raten zurück. Der Händler bekommt den vollen Betrag, das Ausfallrisiko trägt der Finanzierungspartner.

In WEBSALE V8s ist der Ratenkauf eine einzige Zahlungsart mit einem einzigen Abschnitt in der Shopkonfiguration. Welcher Partner dahintersteht, entscheidet die Freischaltung durch WEBSALE. Unterstützt wird derzeit **easyCredit**.

Diese Seite beschreibt den gemeinsamen Rahmen. Die eigentliche Einrichtung mit Ratenrechner, Template-Anpassungen und Prüfstrecke steht auf der Seite zu easyCredit.

Wegweiser: [easyCredit-Ratenkauf](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/easycredit-ratenkauf.md)

## Voraussetzungen

Die Zahlungsart muss bei der WEBSALE AG beantragt werden. Sie steht nur zur Verfügung, wenn eine Anbindung an einen Clearing-Anbieter besteht.

Ist die Anbindung nicht freigeschaltet, schaltet der Shop die Zahlungsart beim Einlesen der Konfiguration 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"]}}
<PaymentInstallment-Txt>
   Allow            = yes
   TestMode         = yes
   Name             = Ratenkauf
   NameSuffix       = Zahlen Sie bequem in monatlichen Raten.
   Img              = logo-ratenkauf.png
   RadioOnClick     = selectPayment('~ID~');
   ImgOnClick       = selectPaymentImage('~ID~');
   DelivererID-List = standard

   UseInterestAmountAsPaymentCostsForEasyCredit = yes
</PaymentInstallment-Txt>
```

Die allgemeinen Parameter sind dieselben wie bei jeder anderen Zahlungsart. Hinzu kommt ein Parameter, der über die Zinsen entscheidet.

## Wie die Zinsen verbucht werden

Ein Ratenkauf kostet den Käufer mehr als der Kaufpreis, denn auf die Finanzierung fallen Zinsen an. Die Frage ist, ob diese Zinsen in Ihrem Shop als Zahlungskosten der Bestellung erscheinen oder nicht.

| Parameter | Bedeutung |
| - | - |
| `UseInterestAmountAsPaymentCostsForEasyCredit` | `yes` führt den Zinsbetrag als Zahlungskosten der Bestellung. Das ist die Voreinstellung. `no` lässt die Zinsen aus den Zahlungskosten heraus |

Die Voreinstellung ist `yes`. Sie müssen den Parameter nur setzen, wenn Sie die Zinsen **nicht** als Zahlungskosten führen wollen.

> [!WARNING]
>
> Der Parameter verändert die Gesamtsumme der Bestellung und damit das, was in Bestelldaten, Bestätigungsmail und Warenwirtschaft ankommt. Stimmen Sie die Einstellung mit dem Verantwortlichen für die Warenwirtschaft und mit der Buchhaltung ab, bevor Sie sie ändern. Ein nachträglicher Wechsel führt zu Bestellungen, die vor und nach der Umstellung unterschiedlich aufgebaut sind.

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

## Hinweismeldungen

Der Ratenkauf ist eine der Zahlungsarten, bei denen eine Ablehnung zum Normalfall gehört. Der Finanzierungspartner prüft die Bonität, und fällt die Prüfung negativ aus, steht der Käufer mit einem gefüllten Warenkorb ohne Zahlungsart da. Hinterlegen Sie deshalb beide Meldungen und schreiben Sie sie so, dass der Käufer weiß, was er als Nächstes tun kann.

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<NotifyMessages-Txt>
   Installment-ClearingError = Die Finanzierung konnte nicht abgeschlossen werden. Bitte versuchen Sie es erneut oder wählen Sie eine andere Zahlungsart.
   Installment-ClearingDeny  = Die Finanzierung wurde abgelehnt. Bitte wählen Sie eine andere Zahlungsart.
</NotifyMessages-Txt>
```

| Meldung | Wann sie erscheint |
| - | - |
| `Installment-ClearingError` | Der Vorgang ist gescheitert oder wurde abgebrochen |
| `Installment-ClearingDeny` | Der Finanzierungspartner hat abgelehnt |

Formulieren Sie die Ablehnung neutral und ohne Begründung. Sie kennen den Grund nicht, und der Finanzierungspartner nennt ihn Ihnen auch nicht.

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

## Auswahl im Bestellablauf

Der Ratenkauf erscheint zusammen mit allen anderen Zahlungsarten über `~WS-PaymentFields~` auf `ws_pay_deliv.htm`.

Anders als bei den meisten Zahlungsarten bleibt es dabei aber nicht. Der Käufer muss vor der Bestellung den Ratenplan sehen und bestätigen, und dafür sind Template-Anpassungen nötig. Wie das aussieht, steht auf der Seite zu easyCredit.

Wegweiser: [easyCredit-Ratenkauf](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/easycredit-ratenkauf.md)

## Verwandte Themen

* Wegweiser: [easyCredit-Ratenkauf, für die vollständige Einrichtung](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/easycredit-ratenkauf.md)
* Wegweiser: [Zahlungsarten anlegen, für die allgemeinen Parameter und die Ausgabe im Template](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/zahlungsarten-anlegen.md)
* Wegweiser: [Versandarten anlegen, für die Kopplung über `DelivererID-List`](https://dokumentation.websale.de/v8s/versandarten-anlegen/versandarten-anlegen)


## Related topics

- [EASYCREDIT- (Ratenkauf)](https://dokumentation.websale.de/v8s/referenz/tags/easycredit.md)
- [easyCredit-Ratenkauf](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/easycredit-ratenkauf.md)
- [Zahlungsarten](https://dokumentation.websale.de/v8s/referenz/konfigurationen/shopkonfiguration-shop-config/zahlungsarten.md)
- [PAY- (Zusatzfelder zur Zahlungsart)](https://dokumentation.websale.de/v8s/referenz/tags/pay/zusatzfelder-zur-zahlungsart.md)
- [Zahlungsarten anlegen](https://dokumentation.websale.de/v8s/zahlungsarten-anlegen/zahlungsarten-anlegen.md)


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