# abilita PAY SW6 Installationsanleitung (DE)

[Show english instructions](https://onedrop.getoutline.com/s/6b6ed6f5-070d-4acd-88af-27d817df3485)

## Das Plugin installieren

Folgen Sie dieser Anweisung um das Plugin in ihrem Shopware 6 Shop zu installieren:

<https://docs.shopware.com/de/shopware-6-de/Erweiterungen/MeineErweiterungen?category=shopware-6-de/einstellungen/system#erweiterungen-installieren>


## Das Plugin konfigurieren

Folgen Sie dieser Anweisung, um zur Plugin-Konfiguration zu gelangen:

<https://docs.shopware.com/de/shopware-6-de/Erweiterungen/MeineErweiterungen?category=shopware-6-de/einstellungen/system#erweiterungen-konfigurieren>


## **abilita-spezifische Plugin-Konfiguration**

### API Zugangsdaten

Die API Zugangsdaten finden Sie in Ihrem abilita Dashboard. Klicken Sie nach dem einloggen oben rechts auf "MEIN UNTERNEHMEN". Auf dieser Seite können Sie Ihre API Zugangsdaten einsehen und zurücksetzen:

 ![](https://storage.1drop.de/outline/uploads/a3f5260a-506d-4ce5-836d-380e44a79d03/cb1a2686-d075-4a77-82f3-97067a2906ff/image?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=minioadmin%2F20261121%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20261121T110000Z&X-Amz-Expires=86400&X-Amz-Signature=2b63e643b11a135922b2b050efb3a9c56fd4cae1b074ba37372fd6d645eb8a1e&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)

Für die Konfiguration im Plugin benötigen Sie den API Key, Incoming Key und Outgoing Key.

Tragen Sie diese Schlüssel in der Plugin Konfiguration in der Shopware 6 Administration ein.

 ![](https://storage.1drop.de/outline/uploads/a3f5260a-506d-4ce5-836d-380e44a79d03/9ef9501e-d370-4969-892a-aa58337332a1/image?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=minioadmin%2F20261121%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20261121T110000Z&X-Amz-Expires=86400&X-Amz-Signature=d46187796e1e78ff44886c364c064d8e0579bb912f59fdd2f1f30be40e0b4464&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)

**API Key (1):** Tragen Sie hier bitte entsprechend den Live oder Test-Key ein.

**Outgoing Key (2):** Tragen Sie hier bitte entsprechend den Live oder Test-Key ein.

**Incoming Key (3):** Tragen Sie hier bitte entsprechend den Live oder Test-Key ein.

**Testmodus aktivieren (4):** Mit dieser Option können sie den Testmodus aktivieren um die Zahlungsarten zu testen. Testdaten für die Zahlungsarten finden Sie hier:

<https://testdashboard.abilitapay.de/docs/#test-payment-data>


### Zahlungsarten Einstellungen

 ![](https://storage.1drop.de/outline/uploads/a3f5260a-506d-4ce5-836d-380e44a79d03/e07a2bf3-0ea1-465c-9184-d64996e5868f/image?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=minioadmin%2F20261121%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20261121T110000Z&X-Amz-Expires=86400&X-Amz-Signature=911b5a077c36a1eb5afcecad34ad5f981677cd7ee49202b5f1ad95ca5d969046&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)

**Vorabprüfung aktivieren (1):** Wird diese Option gewählt, dann findet vor dem Kaufabschluss eine Prüfung statt (Risk-Check), welche Zahlungsarten für den Kunden möglich sind. Es werden dann nur die Zahlungsarten angezeigt, die den Kunden erlaubt sind, zu verwenden.

**Zahlartwechsel nach Bestellabschluss nicht erlauben:** Um einen reibungslosen Ablauf mit dem Payment Gateway zu gewährleisten und um zu vermeiden, dass Zahlungen mehrfach beim Kunden abgerechnet werden, muss die Option "Zahlartwechsel nach Bestellabschluss erlauben" deaktiviert werden. Ggf. handelt es sich hier um eine Default-Einstellung, prüfen Sie jedoch bitte, ob dies der Fall ist. Unter Einstellungen ➝ Zahlungsarten ➝ Kreditkarte (Beispiel) können Sie den die Option deaktivieren.

 ![](https://storage.1drop.de/outline/uploads/a3f5260a-506d-4ce5-836d-380e44a79d03/0a2eeace-e715-494b-9717-030d9ad1e02e/image?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=minioadmin%2F20261121%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20261121T110000Z&X-Amz-Expires=86400&X-Amz-Signature=9317c1053e24be0af1c26efb25729541e000dac0151723c7a7bcc4bc6675f1f0&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)  ![](https://storage.1drop.de/outline/uploads/a3f5260a-506d-4ce5-836d-380e44a79d03/17b1c835-3e57-45d2-8203-0bab1813eb94/image?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=minioadmin%2F20261121%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20261121T110000Z&X-Amz-Expires=86400&X-Amz-Signature=cc49b24a2e471f2677559bea93a13b0a4ed5d0c9e38d93086ee73e2e41562afa&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)


### Bezahlstatus an einer Bestellung automatisch setzen

 ![](https://storage.1drop.de/outline/uploads/a3f5260a-506d-4ce5-836d-380e44a79d03/04bc72d6-d9b2-410b-b3e5-95c82bc94655/image?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=minioadmin%2F20261121%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20261121T110000Z&X-Amz-Expires=86400&X-Amz-Signature=f8583e2fc5ffb0f6489f7d9a3e731520ae2eca2e31d1fea94b6531fd864e3dad&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)

**Bezahlstatus an einer Bestellung automatisch setzen (1):** Hier ist es Ihnen möglich, Ihr Mapping zwischen den abilita-Status und den Shopware-Status zu setzen. Wenn dies nicht durchgeführt wird, gelten die jeweiligen Standardeinstellungen von abilita (wie im Screenshot ersichtlich). Bitte ändern Sie die Einstellungen nur in Absprache mit abilita. Eine genauere Erklärung über jeden Status finden Sie bei der jeweiligen Option bei dem Fragezeichen **(?)**.


### Logging

 ![](https://storage.1drop.de/outline/uploads/a3f5260a-506d-4ce5-836d-380e44a79d03/b94ab35a-75c5-42c6-9153-ac7d9366fc89/image?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=minioadmin%2F20261121%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20261121T110000Z&X-Amz-Expires=86400&X-Amz-Signature=6b5b22a11e7b5876dee66994c26e94fe66232ae7c446a3e0b49f244d0d935700&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject " =602x161")

**Minimales Log Level (1):** Mit dieser Einstellung lässt sich die Menge des Logs konfigurieren. Standard ist hier das minimale Log Level "Info" eingestellt. Im Live-Betrieb sollte diese Einstellung auf "Warning" gesetzt werden, um nicht zu viele Daten zu protokollieren.


## Checkliste Voraussetzungen Zahlungsgarantie coin4

Für unsere Bezahlmethoden coin4Rechnung und coin4Lastschrift bieten wir Ihnen unsere 100%ige Zahlungsgarantie, mit Ausnahme der in Anlage 3 zum Servicevertrag aufgeführten Umstände (<https://abilita.de/dokumente>).

Um sich bestmöglich davor zu schützen, sollten zumindest die von Ihnen über Ihre Shop-Backend steuerbare Umstände unbedingt überprüft werden. Dazu zählen:


### **Abfrage der Telefonnummer**

Stellen Sie sich, dass die Telefonnummer (welche Voraussetzung für die Delkredere-Haftung ist) im Checkout abgefragt und somit an uns übertragen wird. Die Einstellung können Sie hier treffen:  
 ![](https://storage.1drop.de/outline/uploads/0790aad3-9f40-4597-96dd-e3e1d6c7c48e/04e8ddb4-47b5-4ad3-a5db-f57360f08941/image.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=minioadmin%2F20261121%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20261121T110000Z&X-Amz-Expires=86400&X-Amz-Signature=3d65c161c1577a806d5edaa330eb5d189c783f838e22190341974ec0a895f526&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject " =893x188")


### **Abfrage des Geburtsdatums**

Das Geburtsdatum wird automatisch bei Auswahl unsere Bezahlmethoden coin4Rechnung und coin4Lastschrift beim Käufer abgefragt. Hierfür müssen Sie keine extra Einstellung vornehmen. Der Hinweis erfolgt hier nur zu Ihrer Information.


### **Abweichende Lieferadresse deaktivieren (Plugin-Versionen 4.0.2 und 3.0.9)**

Bei Update des Plugins auf die Version 4.0.2 bzw. 3.0.9 wird automatisch eine Rule angelegt, die den Checkout blockiert, sobald eine abweichende Lieferadresse verwendet wird und der Kunde die Zahlungsart “Kauf auf Rechnung” oder “SEPA Lastschrift” gewählt hat.