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

|
|
|
|
|
|
### CrefoPay Rechnungskauf
|
|
|
|
|
|
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:
|
|
|
|
... | ... | @@ -153,7 +228,7 @@ Benachrichtigungs-URL = <https://{www.meinshop.de}/?wc-api=notification_callback |
|
|
|
|
|
{www.meinshop.de}: Bitte mit der Base-URL des Shopsystems ersetzen. Beispiel: www.meinshop.de/woocommerce
|
|
|
|
|
|

|
|
|

|
|
|
|
|
|
---
|
|
|
Hinweis:
|
... | ... | @@ -166,7 +241,7 @@ Für die folgenden Schritte ist eine administrative Berechtigung erforderlich. |
|
|
3. Hinterlegen Sie im Feld `Benachrichtigungsziel-URL` Ihre individuelle Benachrichtigungs-URL.
|
|
|
4. Vergessen Sie nicht Ihre Einstellungen zu Speichern.
|
|
|
|
|
|
#### Konfiguration der Benachrichtigungs Verarbeitung
|
|
|
### Konfiguration der Benachrichtigungs Verarbeitung
|
|
|
|
|
|
Um die Verarbeitung der Benachrichtigungen einer Bestellung anzustoßen, stellt das CrefoPay Plugin die API Funktion `notification_process` bereit.
|
|
|
|
... | ... | @@ -181,6 +256,6 @@ Wir empfehlen dringend die Einrichtung eines Server CronJob. [Siehe auch](https: |
|
|
*/15 * * * * curl https://www.meinshop.de/?wc-api=notification_process >>/var/log/cron-log-$(date +%Y-%m-%d)
|
|
|
```
|
|
|
|
|
|
#### Konfiguration der Bestellstatus
|
|
|
### Konfiguration der Bestellstatus
|
|
|
|
|
|
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) |