Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


UI Steps


UI Step

Voraussetzungen

Sie brauchen unbedingt einen aktiven PAYONE – Account. Wenn Sie noch keinen Account haben, kontaktieren Sie uns bitte.


UI Step

Installation des Plugins

Sie haben 3 Möglichkeiten unser Plugin zu installieren:

UI Expand
titleInstallation direkt im Shopware - Admin
  1. „Kaufen“ Sie sich das kostenlose PAYONE Plugin im Shopware Store.
  2. Laden Sie sich das Plugin in Ihrem Shop unter Einstellungen → System → Plugins herunter.
  3. Installieren und aktivieren Sie das Plugin.



UI Expand
titleInstallation via Composer

Installation directly in Shopware - Admin

Code Block
composer require payone-gmbh/shopware-6
php bin/console plugin:install PayonePayment
php bin/console plugin:activate PayonePayment
php bin/console cache:clear



UI Expand
titleInstallation via Github


Section


Column
width33%



Column
width33%

UI Button
colorgreen
newWindowtrue
sizelarge
displayblock
icondownload
titleDownload from Github
urlhttps://github.com/PAYONE-GmbH/shopware-6/releases


Column
width33%






UI Step

Konfiguration im PAYONE - Portal

Um den Transaktionsstatus an die richtige Adresse zu senden, melden Sie sich bitte im PAYONE Merchant Interface (PMI) an.


Unter Konfiguration → Zahlungsportale → IHR_PORTAL → Erweitert → TransactionStatus URL tragen Sie bitte folgende URL ein:

UI Text Box
typeinfo

<shoproot>/payone/webhook

Additional Response-data

Setzen Sie unter General, die Additional Response-data sowohl für Live als auch für Test auf "on".


UI Step

Konfiguration im Shopware 6 - Admin

  • Klicken Sie unter Einstellungen → Plugins → PAYONE

  • Tragen Sie hier bitte Ihre Zugangsdaten ein:

  • Anschließend aktivieren Sie in den Vertriebskanaleinstellungen die Zahlungsarten für Ihre verwendeten Vertriebskanäle:

  • Jede Zahlungsart kann mit separaten Zugangsdaten genutzt werden. Diese können direkt in der Zahlungsart unter Einstellungen -> Erweiterungen → PAYONE eingetragen werden.

Spezielle Anpassungen

Einige Zahlungsarten benötigen spezielle Anpassungen. Die nächsten Punkte sind für Sie nur interessant, wenn Sie die jeweilige Zahlungsart nutzen:

UI Expand
titlePayone Gesicherter Rechnungskauf

Diese Zahlungsart benötigt ein eigenes Zahlungsportal. Bitte tragen Sie unter Einstellungen → Erweiterungen → PAYONE → Gesicherter Rechnungskauf eine separate Portal ID ein


UI Expand
titlePayone Vorkasse

Um Kunden die Bankverbindung mitzuteilen, haben wir einen Block mit Verrechnungsdaten in die Rechnungsvorlage aufgenommen. Es macht Sinn, diese Daten ebenfalls in die E-Mail-Vorlage der Bestellbestätigung zu integrieren. Wir haben derzeit keine detaillierte Anleitung verfügbar.


UI Expand
titlePaysafe

Um Paysafe anbieten zu können, müssen im Backend die Zahlungsarten zusätzlich konfiguriert werden:

  • Paysafe Pay Later Rechnung

Unter Einstellungen → Erweiterungen → PAYONE → Paysafe Pay Later Rechnung müssen folgende Daten hinterlegt werden: Firmenname (für die ergänzenden AGB), IBAN und BIC (beides wird neben der Zahlungsreferenz angezeigt). Aktivieren Sie den B2B Schieber, wenn Sie B2B Bestellungen annehmen wollen.

  • Paysafe Pay Later Ratenzahlung

Unter Einstellungen → Erweiterungen → PAYONE → Paysafe Pay Later Ratenzahlung müssen folgende Daten hinterlegt werden: Firmenname (für die ergänzenden AGB), Channel Name und Channel Passwort (beides erhalten Sie von Paysafe).



UI Step

Aktivieren der Zahlungsarten

Aktivieren Sie die gewünschten Zahlungsarten unter Einstellungen → Shop → Zahlung.


UI Step

Bearbeiten der Bestellungen

Das PAYONE Plugin setzt den Zahlungsstatus einer Bestellung entsprechend der eingestellten Statuszuordnung.

Erfassung/ Capture

Vorautorisierte Transaktionen können über die Schaltfläche "Capture" in den Bestelldetails erfasst werden.

Rückerstattung/ Refund

Über die Schaltfläche „Refund“ kann eine Bestellung (im Status „bezahlt“) zurückerstattet werden.

Teilerfassung und -rückerstattung

Sie können eine Bestellung teilweise erfassen oder erstatten, indem Sie eine Bestellposition auswählen und die Menge bearbeiten. Der Erfassungsbetrag wird dynamisch angepasst.

Wenn Sie die Bestellung vollständig erfassen oder erstatten wollen, klicken Sie auf "Vollständige Erfassung".

Sie können auch direkt den gewünschten Betrag in das Feld "Erfassungsbetrag" eingeben.

Erfassungen und Erstattungen sind nur möglich, nachdem der Shop einen Transaktionsstatus für eine Bestellung erhalten hat, daher sind die Schaltflächen für Erfassungen und Erstattungen direkt nach einer Bestellung ausgegraut.


UI Step

Erweiterte Konfigurationen

Hier finden Sie separate Einstellungsmöglichkeiten, mit den Sie unser Plugin genauer an Ihre Bedürfnisse anpassen können

UI Expand
titleDetailed status mapping (global)

Unter Einstellungen → Erweiterungen → PAYONE → Statusmapping können Sie die Status individuell zuordnen, auf die die Bestellungen gesetzt werden sollen, sobald die jeweilige Information von der PAYONE Plattform gesendet wird.


UI Expand
titleDetailed status mapping (by payment method)

Unter Einstellungen → Erweiterungen → PAYONE können Sie die Status für jede Zahlungsmethode einzeln zuweisen. Bitte wählen Sie die Zahlungsmethode und aktivieren Sie "Statusmappingkonfiguration einblenden".


UI Expand
titleCSS adjustments credit card

Folgende Anpassungen sind nicht notwendig, um Kreditkartezahlungen anzubieten. Wir beschreiben hier die Möglichkeit die Zahlungsart optisch im Frontend anzupassen:

Sie können das CSS ändern, indem Sie ein neues Plugin erstellen, das von diesem Plugin über Composer abhängt. Hier können Sie dann ein überschreibendes JavaScript-Plugin wie dieses definieren:

Code Block
languagephp
import PayonePaymentCreditCard from '../../../../../PayonePayment/src/Resources/storefront/credit-card/payone-payment.credit-card';

export default class MyPayonePaymentCreditCard extends PayonePaymentCreditCard
{
    getFieldStyle() {
        const style = super.getFieldStyle();

        style.push('height: 300px');

        return style;
    }
    getSelectStyle(){
        const style = super.getSelectStyle();

        style.push('background-color: black');

        return style;
    }
}

Dann können Sie das überschreibende Plugin hier importieren custom/plugins/MyPlugin/src/Resources/storefront/main.js:

Code Block
languagephp
import MyPayonePaymentCreditCard from './my-payone-payment/my-payone-payment.credit-card.plugin';

const PluginManager = window.PluginManager;
PluginManager.override('PayonePaymentCreditCard', MyPayonePaymentCreditCard, '[data-is-payone-credit-card]');

// Necessary for the webpack hot module reloading server
if (module.hot) {
    module.hot.accept();
}



UI Expand
titleBerechtigungsverwaltung

Wenn Sie das Rechtemanagement von Shopware nutzen, geben Sie bitte allen Nutzern die Berechtigung. Unter Einstellungen → System → Benutzer&Rechte → Rolle erstellen Sie eine neue Rolle oder updaten Sie eine bestehende Rolle. Aktivieren Sie das Recht PAYONE Transaktionsmanagement.





Quick Facts


Integrationquickfacts
TXURLpayone/webhook
Repohttps://github.com/PAYONE-GmbH/shopware-6/releases/tag/v2.3.2
Version2.3.2
SHOPID5
Systemshopware6

Inhaltsverzeichnis


Table of Contents
maxLevel2
outlinetrue
indent2em