Aktuelle Version vom 16. Juni 2021, 14:34 Uhr

Einführung

Alipay ist ein chinesisches Onlinebezahlsystem der Alibaba Group und kann über das Modul M-Stripe angebunden werden.

Für die Nutzung brauchen Sie einen Account bei [Stripe]. Die Einrichtung von Alipay erfolgt direkt bei Stripe, Ihre Mauve ApoShop kommuniziert mit Stripe (quasi als Vermittler).

Hinweis: Es wird nur Alipay unterstützt.

Funktionsweise

Der Kunde wählt im Mauve ApoShop die Zahlungsweise Alipay aus und schließt seinen Einkauf ab. Er wird von der Bestellübsichtsseite nach dem Klick auf jetzt Kaufen zu Alipay (Stripe) weitergeleitet.

Dort scannt der Kunde den angezeigten QR Code mit Hilfe seiner Alipay APP und führt die Zahlung durch. Alipay (Stripe) meldet die Zahlung an den Mauve ApoShop, der Auftrag wird abgeschlossen und die Zahlung (Transit-Zahlung) angelegt.

Eine Rückzahlung, sowie Retouren und co. sind derzeit nicht über das Mauve System3 möglich - führen Sie ggf. den Retouren-Prozess wie gewohnt durch und erstatten die Zahlung manuell über Ihr Alipay (Stripe) Backend.

So genannte ePayment-Stati nutzt M-Stripe derzeit nicht, die Zahlung wird nur angelegt, wenn diese auch erfolgreich war - für eine Verarbeitung im Mauve System3, genügt es also auf die Zahlung zu prüfen.

Hinweis: Im Testmodus wird bei Stripe kein QR-Code für die Zahlung angezeigt, sondern eine Testseite mit Rohdaten der Zahlungsinformationen. Dort kann man per Klick entscheiden ob man eine erfolgreiche oder fehlgeschlagene Zahlung simulieren möchte.

Einstellungen

M-Stripe Accounts verwalten

Über die Button Hinzufügen/Bearbeiten können Stripe Account hinzugefügt bzw. bearbeitet werden. Der Dialog ist über den Menüpunkt Zahlung -> M-Stripe (Alipay) zu erreichen.

Hinterlegen Sie idealerweise einen internen Namen, damit Sie den Account Ihrer Zahlungsweise eindeutig zuordnen können.

M-Stripe Accounts hinzufügen/bearbeiten

Public Key Public Key (öffentlicher Schlüssel) für Ihre Stripe-Schnittstelle, achten Sie darauf keine unsichtbaren Sonderzeichen (Umbruch, Tab, Leerzeichen) mitzukopieren. Wie Sie den Key abrufen ist hier beschrieben -> API-Daten
Private Key Private Key (geheimer Schlüssel) für Ihre Stripe-Schnittstelle, achten Sie darauf keine unsichtbaren Sonderzeichen (Umbruch, Tab, Leerzeichen) mitzukopieren.
Webhook Key Webhook Key für Ihre Stripe-Schnittstelle, achten Sie darauf keine unsichtbaren Sonderzeichen (Umbruch, Tab, Leerzeichen) mitzukopieren. Die s.g. Webhook ermöglicht eine Zahlungsbenachrichtung an Ihren Aposhop zu senden.
Verrechnugs Finanzkonto Das Finanzkonto, auf das die Zahlung (Transitzahlung -> Gesamtbetrag ohne Gebühren gesondert auszuweisen) gebucht werden soll.
Testmodus Aktiviert die Test-Schnittstelle zu Stripe
Name (intern) Interner Name der Konfiguration, zum Beispiel "Livedaten - Account xy"

API-Daten

Public Key Den Public Key finden Sie im Stripe Dashboard unter Entwickler -> API-Schlüssel im Feld Veröffentlichbarer Schlüssel.
Private Key Den Private Key finden Sie im Stripe Dashboard unter Entwickler -> API-Schlüssel im Feld Geheimschlüssel.

Hinweis: Achten Sie im Stripe-Dashboard auf den Testdaten-Schalter um ggf. Test- bzw. Livedaten abzurufen.

Webhook

Schritt 1 - Webhook-Seite aufrufen

Im Stripe Dashboard können Sie eine Webhook hinzufügen, zu finden unter Entwickler -> Webhooks.

Hinweis: In den Webhook-Logs werden die Zahlungsbenachrichtungen an Ihren ApoShop protokolliert und auch ggf. Fehler aufgeführt, sollte sich ein Fehler in der Konfiguration der Webhook eingeschlichen haben.

Schritt 2 - Webhook hinzufügen

Endpunkt-URL Die URL lautet immer https://www.ihreDomain.de/checkout/payment/notification/stripe (www.ihreDomain.de bitte austauschen).
Beschreibung Optional, bspw. Mauve ApoShop
Zu sendende Ereignisse Fügen Sie bitte das Event payment_intent.succeeded hinzu

Schritt 3 - Webhook Key auslesen

Kopieren Sie den Webhook Key in Ihre Einstellungen, achten Sie darauf keine unsichtbaren Sonderzeichen (Umbruch, Tab, Leerzeichen) mitzukopieren.

@@ Zeile 3: / Zeile 3: @@
 = Einführung =
+[[Bild:AlipayLogo.png|right|300px]]
 Alipay ist ein chinesisches Onlinebezahlsystem der Alibaba Group und kann über das Modul M-Stripe angebunden werden.
 Für die Nutzung brauchen Sie einen Account bei [[https://stripe.com/de Stripe]]. Die Einrichtung von Alipay erfolgt direkt bei Stripe, Ihre Mauve ApoShop kommuniziert mit Stripe (quasi als Vermittler).
 '''Hinweis:''' Es wird nur Alipay unterstützt.
 <br style="clear:both" />
 =Funktionsweise=
 [[Bild:MStripeZahlungApoShop.png|right|thumb]]
 Der Kunde wählt im Mauve ApoShop die Zahlungsweise '''Alipay''' aus und schließt seinen Einkauf ab. Er wird von der Bestellübsichtsseite nach dem Klick auf '''jetzt Kaufen''' zu Alipay (Stripe) weitergeleitet.
-Dort scannt der Kunde den angezeigten QR Code mit Hilfe seiner Alipay APP und führt zu Zahlung durch. Alipay (Stripe) meldet die Zahlung an den Mauve ApoShop, der Auftrag wird abgeschlossen und die Zahlung (Transit-Zahlung) angelegt.
-Eine Rückzahlung, sowie Retouren und co. sind derzeit nicht über das Mauve System3 nötig - führen Sie ggf. den Retouren-Prozess wie gewohnt durch und erstatten die Zahlung manuell über Ihr Alipay (Stripe) Backend.
+Dort scannt der Kunde den angezeigten QR Code mit Hilfe seiner Alipay APP und führt die Zahlung durch. Alipay (Stripe) meldet die Zahlung an den Mauve ApoShop, der Auftrag wird abgeschlossen und die Zahlung (Transit-Zahlung) angelegt.
+Eine Rückzahlung, sowie Retouren und co. sind derzeit nicht über das Mauve System3 möglich - führen Sie ggf. den Retouren-Prozess wie gewohnt durch und erstatten die Zahlung manuell über Ihr Alipay (Stripe) Backend.
 So genannte '''ePayment-Stati''' nutzt M-Stripe derzeit nicht, die Zahlung wird nur angelegt, wenn diese auch erfolgreich war - für eine Verarbeitung im Mauve System3, genügt es also auf die Zahlung zu prüfen.
@@ Zeile 18: / Zeile 25: @@
 [[Bild:MStripeTestZahlungApoShop.png|right|thumb]]
-'''Hinweis:''' Im Testmodus wird bei Stripe kein QR-Code für die Zahlung angezeigt, sondern eine Testseite mit Rohdaten der Zahlungsinformationen. Dort kann man per Klick entscheiden ob man eine erfolgreiche oder fehlgeschlagene Zahlung simulieren möchte.
+'''Hinweis:''' Im Testmodus wird bei Stripe kein QR-Code für die Zahlung angezeigt, sondern eine Testseite mit Rohdaten der Zahlungsinformationen.
+Dort kann man per Klick entscheiden ob man eine erfolgreiche oder fehlgeschlagene Zahlung simulieren möchte.
 <br style="clear:both" />
 =Einstellungen=
 ==M-Stripe Accounts verwalten==
 [[Bild:MStripeAccountsVerwalten.png|right|thumb]]
 Über die Button Hinzufügen/Bearbeiten können Stripe Account hinzugefügt bzw. bearbeitet werden. Der Dialog ist über den Menüpunkt Zahlung -> M-Stripe (Alipay) zu erreichen.
 Hinterlegen Sie idealerweise einen internen Namen, damit Sie den Account Ihrer Zahlungsweise eindeutig zuordnen können.
 <br style="clear:both" />
@@ Zeile 48: / Zeile 58: @@
 ===Schritt 1 - Webhook-Seite aufrufen===
 [[Bild:MStripeAPIWebhookHinzufuegen.png|right|thumb]]
-Im Stripe Dashboard können Sie eine Webhook hinzufügen, zu finden unter '''Entwickler''' -> '''Webhooks'''
+Im Stripe Dashboard können Sie eine Webhook hinzufügen, zu finden unter '''Entwickler''' -> '''Webhooks'''.
+'''Hinweis:''' In den Webhook-Logs werden die Zahlungsbenachrichtungen an Ihren ApoShop protokolliert und auch ggf. Fehler aufgeführt, sollte sich ein Fehler in der Konfiguration der Webhook eingeschlichen haben.
 <br style="clear:both" />
@@ Zeile 56: / Zeile 68: @@
 *'''Beschreibung''' Optional, bspw. Mauve ApoShop
 *'''Zu sendende Ereignisse''' Fügen Sie bitte das Event '''payment_intent.succeeded''' hinzu
-'''Hinweis:''' In den Webhook-Logs werden die Zahlungsbenachrichtungen an Ihren ApoShop protokolliert und auch ggf. Fehler aufgeführt, sollte sich ein Fehler in der Konfiguration der Webhook eingeschlichen haben.
 <br style="clear:both" />

M-Stripe (AliPay) Accounts verwalten: Unterschied zwischen den Versionen