Dokumentation

1Shopify Integration

Shopify ist ein kanadisches E-Commerce-Unternehmen mit Hauptsitz in Ottawa, Ontario, das Computer Software für Online-Shops und Kassensysteme für den Einzelhandel entwickelt. Wir haben eine Integration in Shopify’s Payment Gateway, die es Ihnen ermöglicht, Transaktionen mit Ihrer bevorzugten Zahlungsmethode in Ihrem Shopify-Shop verarbeiten zu können. Bitte folgen Sie den detaillierten Schritten um PostFinance CheckoutZahlungen in Ihr Shopify-Backend zu integrieren

BITTE BEACHTEN: Shopify hat einige Änderungen an seiner Plattform vorgenommen. Um Zahlungen zu verarbeiten, müssen Sie die neue Shopify-Zahlungs-App installieren. Die folgenden Funktionen sind mit der neuen Integration nicht mehr verfügbar:

  • Shopify-Abonnements

  • Integriertes Zahlungsformular

  • Rückerstattungen, Zahlungsabschlüsse und Stornierungen sollten nur noch über das Shopify-Backend ausgelöst werden.

2Verbinden Sie Ihren Shopify-Shop

Um PostFinance Checkout in Ihr Shopify einzubinden, müssen Sie die Shopify-Zahlungs-App Ihrer gewünschten Zahlungsmethode installieren.

Sie können Ihren Shopify-Shop über die Shopify-Zahlung Integration verbinden, auf die Sie direkt von Ihrem Space aus zugreifen können: Space > Settings > Shopify Payment

Create Integration
Figure 1. Verwenden Sie die Shopify-Zahlung Integration, um die Zahlungs-App zu installieren und die Zahlungs-App mit Ihrem Shop zu verbinden.

Sie können zu folgendem link navigieren Space > Settings > Shopify Payment, und Ihren Shopify Store dort verbinden.

Bitte folgen Sie den folgenden Schritten, um die Installation abzuschließen:

  1. Klicken Sie auf Shopify-Shop verbinden.

  2. Wählen Sie die bevorzugte Zahlungs-App und geben Sie den Namen Ihres Shops ein.

  3. Sie werden an Shopify weitergeleitet, um die Zahlungs-App zu installieren.

  4. Konfigurieren und aktivieren Sie die Zahlungs-App in Shopify.

Sie können die Zahlungs-App auch in der Liste der Shopify-Zahlungsanbieter finden, wenn Sie zu den Einstellungen Ihres Shops navigieren.

payment-provider
Figure 2. Die Zahlungs-App PostFinance Checkout in der Shopify-Liste der Zahlungsanbieter.

3Zahlungsabwicklung

Der Kunde wird nach der Bestätigung der Bestellung auf die Zahlungsseite des Anbieters weitergeleitet, um die Zahlung abzuschließen.

4Konfigurieren Sie Ihren Processor

Um Zahlungen über das konfigurierte Gateway akzeptieren zu können, müssen Sie sicherstellen, dass Sie Ihren Prozessor, Ihre Zahlungsmethode und Ihren Anschluss richtig konfiguriert haben. Anleitungen dazu, wie der Zahlungsprozessor konfiguriert werden muss, finden Sie unter dem Processor List.

5Zustandsdiagramm

Der Zahlungsprozess ist komplett standardisiert für jede Zahlungsmethode, die Sie verarbeiten können. Dies gibt Ihnen die Möglichkeit, einfach eine Zahlungsmethode oder einen Prozessor ohne Änderungen in Ihrer Shopify-Konfiguration hinzuzufügen. Eine Übersicht über die Status und die Zahlungsprozesse finden Sie unter dem Payment Documentation.

Im folgenden Abschnitt geben wir Ihnen einen Überblick darüber, wie die Zustände der Transaktionen im Shopify-Zustandsdiagramm für Bestellungen abgebildet werden.

5.1Status Abbildung von Shopify-Bestellungen

Das folgende Diagramm zeigt den Zustandsautomaten von Shopify für Bestellungen, einschließlich zusätzlicher Informationen zu den Zustandsübergängen.

state-graph
Figure 3. Transaktionszustandsdiagramm einer Shopify-Transaktion.

6Transaktionsmanagement

Sie können Transaktionen direkt über das Shopify-Backend erfassen, stornieren und erstatten. Bitte beachten Sie, dass die Ereignisse NICHT mit Shopify synchronisiert werden, wenn Sie Transaktionen von PostFinance Checkout erfassen, stornieren oder erstatten.

6.1Abschließen (Erfassen) einer Bestellung (in Shopify)

Sie haben die Möglichkeit für Ihre Transaktionen, die Zahlung erst nach der Bestellung zu autorisieren. In Shopify Einstellungen > Zahlungen haben Sie die Möglichkeit, festzulegen, ob die Zahlung sofort oder verzögert ausgeführt werden soll.

payment-capture
Figure 4. Wählen Sie Ihre bevorzugte Zahlungserfassungsmethode.

Um eine Transaktion in Shopify abzuschließen, öffnen Sie die Bestellung und klicken Sie auf die Schaltfläche Zahlung erfassen.

Damit wird die Bestellung abgeschlossen und kann nicht mehr geändert werden.

Note
Wenn der Abschluss ausstehend in PostFinance Checkout ist, bleibt die Bestellung im autorisierten Zustand.
capture-transaction
Figure 5. Erfassen Sie eine Transaktion.

Aufgeschobene Zahlungsabwicklung

Einige Einzelhändler möchten Transaktionen erst dann genehmigen und den Erfüllungsprozess starten, wenn alle Artikel versandt werden können.

Dies ist möglich, allerdings sollten dabei bestimmte Prozesse befolgt werden. Wenn Sie den Zahlungsabschluss so konfiguriert haben, dass er aufgeschoben wird, sollten Sie die Transaktion erfassen, bevor Sie den Versand einleiten, da es vorkommen kann, dass ein Abschluss fehlschlägt. Wenn Sie sichergehen wollen, dass Sie keine Artikel versenden, für die Sie noch nicht bezahlt wurden, sollten Sie den Versand aufschieben, bis der erfüllte Zustand erreicht ist. Die Transaktion wechselt nach der Erstellung in den Status Authorized im PostFinance Checkout und in Shopify. Wenn Sie den Erfüllungsprozess starten möchten, stellen Sie sicher, dass Sie den Abschlussprozess wie oben beschrieben einleiten. Sobald der Abschluss erfolgreich ist, wechselt die Bestellung in den Status Fulfill in PostFinance Checkout und in den Status Paid in Shopify. Sie können nun den Erfüllungsprozess starten.

Warning
Der Abschluss der Transaktion kann nur von der Shopify-Shop Seite aus vorgenommen werden. Bitte vermeiden Sie es, den Abschluss der Transaktion von PostFinance Checkout auszuführen, um Inkonsistenzen zu vermeiden.

6.2Stornieren einer Transaktion (in Shopify)

Um eine Transaktion zu stornieren, klicken Sie auf die Schaltfläche Weitere Aktionen und dann auf die Schaltfläche Bestellung stornieren.

Note
Sie können nur Transaktionen stornieren, die noch nicht abgeschlossen sind.
void-transaction
Figure 6. Stornieren Sie eine Transaktion.
Warning
Die Stornierung der Transaktion kann nur auf der Shopify-Shop Seite durchgeführt werden. Bitte vermeiden Sie es, die Stornierung der Transaktion von PostFinance Checkout auszuführen, um Inkonsistenzen zu vermeiden.

6.3Rückerstattung einer Transaktion (in Shopify)

Sie haben die Möglichkeit, bereits abgeschlossene Transaktionen zu erstatten. Öffnen Sie dazu den erfassten Auftrag. Wenn Sie auf Rückerstattung klicken, wird das Fenster für die Rückerstattung angezeigt.

refund-transaction
Figure 7. Rückerstattung einer Transaktion.
Note
Vergewissern Sie sich, dass der Connector, der diese Zahlung verarbeitet hat, die Erstattungen unterstützt. Um dies zu überprüfen, sehen Sie sich den processor list und überprüfen Sie den Stecker eines Prozessors.

Sehen Sie sich das Beispiel eines AMEX-Connectors an, der Rückerstattungen unterstützt.

feature-refund

Sie können Erstattungen auf der Grundlage der Produktmenge vornehmen. Geben Sie dazu die Anzahl der Produkte an, die Sie Ihren Kunden erstatten möchten.

refund-transaction
Figure 8. Rückerstattung einer Transaktion.

Sie können so viele individuelle Rückerstattungen durchführen, bis Sie die Menge der ursprünglichen Bestellung erreicht haben. 

Note
Es kann einige Zeit dauern, bis Sie die Rückerstattung in Shopify sehen. Rückerstattungen werden erst sichtbar, wenn sie von Ihrem Prozessor erfolgreich verarbeitet wurden und wenn Rückerstattungen von diesem Prozessor unterstützt werden.
Warning
Die Rückerstattung der Transaktion kann nur von der Shopify-Shop Seite aus vorgenommen werden. Bitte vermeiden Sie es, Erstattungen von PostFinance Checkout auszuführen, um Inkonsistenzen zu vermeiden.

6.4Zurückgehaltene Bestellungen (in Shopify)

Wenn eine Lieferung noch nicht erfolgt ist, befindet sich der Status der Bestellung im Zustand Authorized. Dies ist der Fall, wenn die Transaktion den Status erfüllt in PostFinance Checkout noch nicht erreicht hat.

Es gibt im Wesentlichen zwei Gründe, warum dies passieren kann:

  • Die Transaktion ist noch nicht abgeschlossen. Wenn dies der Fall ist, müssen Sie die Transaktion wie oben beschrieben abschließen.

  • Wir können Ihnen nicht sagen, ob Sie den Auftrag erfüllen können. Die Entscheidung über die Lieferung wird normalerweise automatisch getroffen. Geschieht dies nicht innerhalb des festgelegten Zeitrahmens, erstellen wir eine manuelle Aufgabe, die Sie beachten und den Anweisungen folgen sollten. 

Weitere Informationen über manuelle Aufgaben finden Sie in unserem Informationen über manuelle Aufgaben.

7Unterstützung für Line Items

Unsere Shopify Zahlungs-Integration bietet jetzt die Unterstützung von Einzelposten. Um sie zu aktivieren, müssen Sie nur eine zusätzliche App in Ihrem Shopify-Shop installieren und diese Funktion wird Ihrem Shop hinzugefügt.

Warning
Bitte beachten Sie, dass die Zollgebühren bei der Verwendung der Line Item App nicht unterstützt werden. Wenn Sie Zollgebühren verwenden möchten, installieren Sie bitte nicht die Zusatz-App.
Warning
Die App Line Item ist nicht mit der Shopify-Zahlungs-App Kreditkarte (vor Ort) kompatibel.