@@ -108,44 +108,119 @@ Wird die Zahlung für eine Bestellung nicht innerhalb der Warenkorbgültigkeit d
### Bestellstatus
Nach erfolgreicher Aktivierung des Plugins stehen in WooCommerce zwei neue Bestellstatus zur Verfügung, die von dem CrefoPay Plugin zur bestehenden Liste der WooCommerce Bestellstatus hinzugefügt werden:
Nach Aktivierung des Plugins stehen in WooCommerce neue Bestellstatus zur Verfügung, die von dem CrefoPay Plugin zur bestehenden Liste der WooCommerce Bestellstatus hinzugefügt werden:
1. Zahlung reserviert: `wc-payment-reserved`
2. Betrugsverdacht: `wc-payment-fraudpending`
3. Mahnung: `wc-payment-dunning`
4. Inkasso: `wc-payment-collection`
Diese können zusammen mit den bestehenden verwendet werden, um den WooCommerce Bestellstatus bei eingehenden CrefoPay Statusbenachrichtigungen zu aktualisieren. Der allgemeine Ablauf einer CrefoPay Bestellung wird in der CrefoPay Online-Dokumentation im Abschnitt [Process desctiption](https://docs.crefopay.de/api/#process-description) erläutert.
Mit der Option `no-state` wird die zugehörige Option bzw. das Aktualisieren des Status für eine Benachrichtigung deaktiviert.
#### CIA Pending
Dieser Status wird gesendet, wenn eine Bestellung per Vorkasse reserviert wurde und noch kein Zahlungseingang registriert wurde.
#### Merchant Pending
Dieser Status wird immer dann gesendet, wenn die Zahlung so weit reserviert/autorisiert wurde, dass die Bestellung nun versendet werden kann.
#### In Progress
Dieser Status taucht bei Rechnungs- und Lastschrift- Zahlungen auf, wenn noch keine Zahlung registriert wurde bzw. der Einzug der Lastschrift noch auf die Bestätigung durch die Bank wartet.
#### Fraud Pending
Dieser Status wird nur dann gesendet, wenn Sie die Fraud-Queue bei CrefoPay aktiviert haben.
#### Fraud Cancelled
Dieser Status wird nur dann gesendet, wenn Sie die Fraud-Queue bei CrefoPay aktiviert haben.
#### Cancelled
Dieser Status wird gesendet, wenn die Zahlung Storniert oder abgebrochen wurde.
#### Expired
Dieser Status wird für Bestellungen gesendet, deren Zahlung niemals erfolgreich abgeschlossen wurde.
#### Done
Dieser Status wird immer dann gesendet, wenn alle offenen Forderungen zu einer Bestellung ausgeglichen wurden.
### Forderungsmanagement
#### In Mahnung
Das CrefoPay Plugin erkennt, ebenfalls über den Benachrichtigungsdienst, wenn eine offene Forderung an das Mahnwesen übergeben wurde und die erste Zahlungserinnerung versendet wurde. Mit dieser Option wird der zugehörige Status für diese Bestellungen festgelegt.
#### Im Inkasso
Ist eine Forderung ausgemahnt wird sie automatisch an das Inkasso der Creditreform übergeben. Auch dies wird per Statusbenachrichtigung an WooCommerce übertragen und der Status kann auf den hier eingestellten Wert aktualisiert werden.
### Automation Tab
Im automation Tab können verschiedene Plugin Automatisierungen eingestellt werden.
Im automation Tab können verschiedene weitere Plugin Automatisierungen eingestellt werden. In diesem Fall geht es aber nicht um die Aktualisierung der Bestellungen in WooCommerce, sondern der Zahlung selbst in CrefoPay, ausgelöst durch Status Veränderungen in WooCommerce.
#### Status für Auto-Cancel
Mit dem Auto-Cancel Status wird der Status festgelegt, der einen Zahlungsvorgang bei CrefoPay storniert. Diese Option ist deshalb mit Vorsicht zu verwenden, weil Zahlungen zu Bestellungen, welche den hier eingestellten Status erreichen, automatisch storniert und ggf. auch bereits geleistete Zahlungen erstattet werden!
#### Status für Auto-Capture
Ein sehr wichtiger Prozessschritt für eine CrefoPay Zahlung ist der Zeitpunkt des [Captures](https://repo.crefopay.de/crefopay/woocommerce/-/wikis/Grundlagen-einer-Zahlung-mit-CrefoPay#capture-buchung). Der hier eingestellte Status führt den Capture automatisch aus, wenn der festgelegte Bestellstatus erreicht wurde.
#### Status für Auto-Finish
Der Auto-Finish kann immer dann sinnvoll eingesetzt werden, wenn es viele Bestellungen gibt, die nicht vollständig, sondern nur anteilig geliefert werden können. Mit dem Finish bzw. Abschließen einer Bestellung bzw. Zahlung, werden automatisch alle überzahlten und nicht gebuchten Beträge der Bestellung ausgeglichen bzw. bei Bedarf erstattet.
## Zahlungsarten
#### Rechnungskauf
Die CrefoPay Zahlungsarten werden direkt im WooCommerce eigenen Abschnitt unter `Einstellungen > Zahlungen` konfiguriert, da jede Zahlungsart als eigenes WooCommerce Payment Gateway definiert ist.
Das Payment Gateway für den CrefoPay Rechnungskauf ist ein direct gateway und erfordert keine Umleitung bei Kaufabschluss. Die Abfrage der Bonität des Endkunden wird automatisch durch CrefoPay geprüft, sofern die entsprechende CrefoPay Option gebucht und im Händler-Account aktiviert wurde.
Das Payment Gateway für den CrefoPay Rechnungskauf ist ein direct Gateway und erfordert keine Umleitung bei Kaufabschluss. Die Abfrage der Bonität des Endkunden wird automatisch durch CrefoPay geprüft, sofern die entsprechende CrefoPay Option gebucht und im Händler-Account aktiviert wurde.
Da für die Bonitätsprüfung von Privatpersonen ein Geburtsdatum erforderlich ist, wird dieses direkt im Checkout bei Auswahl der Zahlungsart abgefragt. Für Firmenkunden wird das Geburtsdatumsfeld zwar angezeigt, für die Bezahlung ist aber keine Angabe notwendig.
```php
// todo: Aktivierung, Date of Birth, Notification Flow
```
### CrefoPay Lastschrift
Das Payment Gateway für den CrefoPay Rechnungskauf ist ein direct Gateway und erfordert keine Umleitung bei Kaufabschluss. Die Abfrage der Bonität des Endkunden wird automatisch durch CrefoPay geprüft, sofern die entsprechende CrefoPay Option gebucht und im Händler-Account aktiviert wurde.
Da für die Bonitätsprüfung von Privatpersonen ein Geburtsdatum erforderlich ist, wird dieses direkt im Checkout bei Auswahl der Zahlungsart abgefragt. Für Firmenkunden wird das Geburtsdatumsfeld zwar angezeigt, für die Bezahlung ist aber keine Angabe notwendig.
### CrefoPay Vorkasse
Das Payment Gateway für die CrefoPay Vorkasse ist ein direct Gateway und erfordert keine Umleitung bei Kaufabschluss.
### CrefoPay Kreditkarte
Das Payment Gateway für die CrefoPay Kreditkarte ist ein Umleitungs-Gateway und erfordert eine Umleitung bei Kaufabschluss.
### CrefoPay PayPal
Das Payment Gateway für die CrefoPay PayPal ist ein Umleitungs-Gateway und erfordert eine Umleitung bei Kaufabschluss.
### CrefoPay Sofort.
Das Payment Gateway für die CrefoPay Sofort. (ehem. Sofortüberweisung) ist ein Umleitungs-Gateway und erfordert eine Umleitung bei Kaufabschluss.
### Verarbeitung Status Benachrichtigungen
## Verarbeitung Status Benachrichtigungen
Die CrefoPay API versendet für jede relevante Statusveränderung einer CrefoPay Transaktion eine Benachrichtigung (MNS). [Siehe auch](https://docs.crefopay.de/api/#notification-call)
Die Zustellung der MNS erfolgt als parametrisierter Post-Request, der von dem Callback Controller `WC_API_Crefo_Notification_Callback` entgegengenommen wird.
Dabei speichert dieser Controller die Informationen zunächst in den Meta-Daten der Bestellung. Die Verarbeitung erfolgt asynchron und kann durch den API Controller `WC_API_CrefoPay` ausgelöst werden.
#### Konfiguration der Benachrichtigungs URL
### Konfiguration der Benachrichtigungs URL
Damit das CrefoPay System den richtigen Controller für die Zustellung der Benachrichtigungen erreichen kann, muss diese in der CrefoPay Konfiguration bekannt gemacht werden. Für den Aufbau der URL, mit der wir diesen Controller erreichen können, gilt:
Sind die Zustellung und die Verarbeitung der Benachrichtigungen konfiguriert, so können wir uns nun den `Status Automatisierungen` widmen. Diesen Abschnitt finden wir in den Einstellungen des CrefoPay Plugins im Wordpress, Backend im Bereich `WooCommerce » CrefoPay`. Hier definieren wir den WooCommcere Bestellstatus, der auf Grundlage eingehender Status-Benachrichtigungen gesetzt werden wird. [Siehe auch](https://docs.crefopay.de/api/#process-description)
