1. EinleitungVorwort zur Integration und DokumentationMit der Unzer APP werden Descartes pixi und Unzer einfach und unkompliziert miteinander verbunden. Alle beschriebenen Prozesse der Zahlungsabwicklung werden automatisiert. Dank SaaS ist eine Installation nicht notwendig und die APP ist immer auf dem aktuellen Stand. Show
Diese Dokumentation ist immer auf dem aktuellen Stand. Es sollte die erste Anlaufstelle bei Fragen und Problemen
sein. 2. Dokumentationunzer AppFunktionsumfangUnterstützte Zahlungsarten
Wenn eine eingesetzte Zahlungsart nicht in der Liste der unterstützten Zahlungsarten zu finden ist, kontaktiere bitte den Support von unzer. Funktioniert
(noch) nicht möglich
ShopmodulUnzer hat für viele Shop-Systeme eine fertige Erweiterung parat. Welche für dein Shop-System am besten geeignet ist, solltest du beim unzer Support erfragen. Voraussetzung ist, dass das eingesetzte Shop-Modul die MGW - Schnittstelle von unzer unterstützt. Die unzer App unterstützt zwei verschiedene Abarbeitungs-Prozesse. Im Standard Modus prüft die App ob eine Bestellung bereits im Online-Shop eingezogen wurde. Sollte das nicht der Fall sein, führt die App den Capture nach dem Bestellimport in pixi aus, sobald die App die Bestellung zum ersten Mal abgeholt hat. Im Erweiterten Modus, wird der Capture nach Versand/Rechnungsstellung in pixi ausgeführt. Allerdings gibt es weiterhin Zahlungsarten, wo der Capture bereits im Online-Shop stattfindet. Bei einigen Shop-Modulen kann eingestellt werden, ob der Capture bereits im Online-Shop ausgelöst wird. iungo CPpixi API-KonfigurationDie pixi API Konfiguration kann im Portal unter dem Menüpunkt pixi API unterhalb von Einstellungen vorgenommen werden. Das ist die wichtigste Konfiguration, auf der alle nachträglichen APP Konfigurationen basieren. Falls die einzutragenden Daten nicht bekannt sind, können diese beim pixi Support angefragt werden. Tipp(s) Um weitere Informationen zu einem Konfigurations-Feld zu bekommen, fährt man mit dem Mauszeiger über das Symbol , dass man auf der rechten Seite neben einem Auswahl-/Eingabefeld findet. E-Mail Konfiguration Mit einer hinterlegten E-Mail Konfiguration kann dich die APP über Fehler
und Probleme benachrichtigen. Tipp(s) Die E-Mail Konfiguration kann jederzeit getestet werden. Sobald du eine Test E-Mail bekommst ist die Konfiguration erfolgreich abgeschlossen. APP buchen Als nächstes kann die APP gebucht werden. Dafür musst du im Portal angemeldet sein, die pixi API und E-Mail Konfiguration hinterlegt haben. Tipp(s) Wir empfehlen die Buchung der APP nachdem die pixi - Shop Schnittstelle angepasst ist und die Konfigurationen auf pixi Seite abgeschlossen ist. Damit hast du mit dem Test-Zeitraum der APP genug Zeit die Prozesse zu testen. Nach Ablauf des Test-Zeitraums ist die APP kostenpflichtig. Konfigurations-CenterNach Buchung der APP kann mit der Konfiguration gestartet werden. Auf der linken Seite im Portal-Menü werden alle gebuchten APP's aufgelistet. Unter jeder APP gibt es einen Menüpunkt Konfiguration. Hier können neue Konfigurationen angelegt, bestehende bearbeitet oder Kopien erstellt werden. Neue Konfiguration anlegen Konfiguration bearbeiten Konfiguration kopieren Achtung! Vorsicht beim Bearbeiten von bestehenden Konfigurationen. Bestellungen die bereits mit einer Konfiguration von der APP bearbeitet wurden, können nach dem Anpassen der Konfiguration einen Fehler hervorrufen, wenn diese nochmal von der APP bearbeitet werden müssen. Tipp(s) Eine Zahlungsart in pixi kann je pixi Mandant eine eigene APP-Konfiguration haben Konfigurations-FelderIm folgenden werden die einzelnen Konfigurations-Felder erklärt.
Dashboard Im Dashboard sind alle Bestellungen aufgelistet, die von der App verarbeitet wurden. Über die vorhandenen Filter können Problembestellungen schnell und einfach gefunden werden. Achtung! Der Button "Problem gelöst" löscht die Fehler-Markierung der Bestellung und führt keine weitere Aktion in der App aus. Tipp(s) Wenn du mit der Maus über das folgende Symbol fährst, werden weitere Informationen eingeblendet. Fehler-SeiteDie Fehler-Seite ist eine weitere Hilfsmöglichkeit um Problem-Bestellungen wahrzunehmen. Der Link zur Fehler-Seite kann in einem Internet-Browser aufgerufen werden, ohne dass ein Login im Portal notwendig ist. Die Fehler-Seite aktualisiert sich jede Minute neu und holt die Daten über die iungo-API verschlüsselt ab. pixiShop-Schnittstelle Die unzer Payment ID muss aus dem Shop in pixi importiert werden. Die unzer Payment ID muss in das Feld KK-ID im pixi Kundenservice importiert werden. Konfiguration Zahlungsarten Die Zahlungsarten der Bestellungen aus dem Shop, müssen mit den Zahlungsarten in pixi verknüpft werden. Ob die Anlage von einer oder mehreren Zahlungsart(en) notwendig ist, hängt von verschiedenen Faktoren ab. Tipp(s): Je weniger Zahlungsarten konfiguriert werden, umso schneller kann die APP arbeiten und deine pixi API wird weniger belastet. Folgende Einstellungen müssen bei der Erstellung Zahlarten beachtet werden?
Achtung: Dies ist nur ein Beispielbild, wie die Konfigurationsmaske in pixi aussieht. Die einzelnen Konfigurationspunkte können bei jedem anders sein und sollten in Absprache mit dem pixi-Support gesetzt werden. Buchungs-EventsIn pixi müssen manuelle Buchungs-Events angelegt werden, falls noch keine existieren. Die Portal-Konfiguration erlaubt es, falls gewünscht, für jede Zahlungsart unterschiedliche Buchungs-Events einzutragen. In der Regel erstellt diese Buchungs-Events der pixi-Support. Folgende Einstellungen müssen bei der Erstellung von Events beachtet werden?
Rechnungs-TemplatesIm Regelfall werden die Rechnungen an deine Kunden aus pixi heraus verschickt. Achte bitte darauf, dass die Rechnungen alle notwendigen Informationen bereitstellen. Ebenso ist es wichtig, dass der Kunde nicht ausversehen den Betrag zusätzlich überweist und somit doppelt abgezogen bekommt. Für einige APP's gibt es bereits Vorlagen oder der Anbieter hat bereits mit pixi abgesprochen wie diese aussehen sollen. Bitte beachte auch, dass die Rechnungen pro Zahlungsart unterschiedlich aussehen können. Tipp(s): Der pixi-Support kann die Rechnungs-Templates anpassen und hat unter Umständen die notwendigen Informationen des Anbieters vorliegen. SOAP API-CallsFür den Betrieb der Erweiterungen müssen folgende SOAP API-Calls auf der Datenbank installiert sein.
3. Prozesse/AbläufeDie unzer App informiert dich über den Status einer Bestellung auf verschiedenen Wegen. In den Bestellkommentaren vom pixi Kundenservice, kannst du sehen wann die App zuletzt etwas gemacht hat. Sollte ein Prozess-Fehler aufgetreten ist, schickt die unzer App eine E-Mail. Über das Dashboard und der Fehler-Seite kannst du jederzeit deine Bestellungen überprüfen. Je nach Auswahl vom App-Modus (Experten oder Standard) arbeitet die unzer App die jeweiligen Prozesse unterschiedlich ab. Bestellung freigebenNachdem die Bestellung mit Status HOLD in pixi importiert wurde, muss zur weiteren Bearbeitung die unzer App diese freigeben. Es wird geprüft, ob die Bestellung von unzer angenommen wurde. Sollte ein Fehler vorligen, wir die Bestellung freigegeben, aber mit einer Versandsperre versehen. Ist die Bestellung erfolgreich geprüft, wird diese freigegeben. Standard-Modus Unzer Prepayment Unzer Invoice und Unzer Invoice Secured
Bitte stelle sicher, dass diese Informationen auf den Rechnungen zu finden sind, die von pixi generiert werden! Bestellung capturenBeim Versand in pixi, versucht die unzer App den entsprechenden Betrag zu aktivieren/capturen und den Versand zu melden. Wenn der Betrag erfolgreich aktiviert wurde, setzt die unzer App auch das Buchungs-Event, sodass im Kundenportal ein Ausgleich sattfindet. Standard-Modus Experten-Modus Unzer Prepayment Unzer Invoice Dieser Vorgang dauert in der Regel 5-10 Minuten. Unzer
Invoice Secured Dieser Vorgang dauert in der Regel 5-10 Minuten. Mit diesem Ereignis startet der Zahlungszeitraum für den Kunden. Bitte beachte, dass zwischen der Bestellung im Online-Shop und diesem Ereignis, nicht zu viel Zeit vergeht. Bestellung stornierenSobald eine Bestellung in pixi storniert wurde, alle Bestellpositionen haben den Status STO oder NLB, wird das an unzer übermittelt. Bei Fehlern wird eine Fehler E-Mail versendet. Standard-Modus Experten-Modus Unzer Prepayment / Unzer Invoice Unzer Invoice Secured Bestellpositionen stornierenWerden nur einzelne Bestellpositionen storniert, arbeitet die unzer App je nach gewählten Modus unterschiedlich. Standard-Modus Experten-Modus Unzer Prepayment Dieser Vorgang dauert in der Regel 5-10 Minuten. Unzer Invoice Dieser Vorgang dauert in der Regel 5-10 Minuten. Unzer Invoice Secured Dieser Vorgang dauert in der Regel 5-10 Minuten. RetourenBei einer Retoure meldet die unzer App den Betrag der Gutschrift an unzer und setzt bei Erfolg das Buchungs-Event für Gutschriften in pixi. Umtauschbestellungen / Manuelle BestellungenManuelle- und Umtausch-Bestellungen können mit einer Zahlungsart erstellt werden, die im Portal konfiguriert ist. Die APP ignoriert solche Bestellungen. Jedoch muss drauf geachtet werden, das die Rechnungen/Gutschriften einer solchen Bestellung ebenfalls im pixi Kundenkonto ausgeglichen werden um weitere Probleme auszuschliessen. Hinweis Die Bedingungen für diesen Ablauf sind, dass die unzer Payment ID nicht vorhanden ist und die Shop-Bestellnummer in pixi aus dem Präfix "P" und der internen pixi Bestellnummer besteht. Ist der Ersatzartikel bei einem Umstausch teurer, muss das Kundenkonto manuell ausgeglichen werden. Weitere Informationen sind in der Dokumentation von pixi zu finden. pixi Dokumentation 4. Integrationsleitfaden
Empfehlung: Voraussetzung
unzerBitte informiere dich vorab beim unzer Support ob dein Shop-Modul die MGW Schnittstelle unterstützt. Welche Daten brauche ich von unzer?
pixiWas muss von pixi angepasst werden?
Welche Daten brauche ich von pixi?
iungo CPSobald die Kommunikation zwischen Shop und pixi funktioniert, kann die Integration bei iungo beginnen. Zuerst muss die Erweiterung gebucht werden. Es gibt einen Testzeitraum, den man zum Testen nutzen sollte. Nach Ablauf des Testzeitraums wird der Betrag jeden Monat automatisch abgebucht. Empfehlung: 5. Migration von ALT zu NEUAllgemein Nutzt du bereits die Heidelpay App bei pixi? Bitte lese diese Dokumentation ausführlich und kontaktiere uns bei Fragen. Kontaktiere pixi um die nächsten Schritte einzuleiten. Dazu gehören, das Anpassen der pixi Shop Schnittstelle, das Anlegen einer neuen Zahlungsart und Buchungs-Events, sowie das Anpassen der Rechnungs-Templates. Beide App's laufen parallel, bis pixi die alte Heidelpay App deaktiviert. 6. FAQAllgemeinDieser Bereicht ist noch im Aufbau Support
Jede Nacht zwischen 00:00 und 04:00 Uhr schickt unsere Plattform keine Anfragen an pixi. Damit wird sichergestellt, dass pixi deine Datenbank sichern kann und dafür alle notwendigen Resourcen bekommt. Wer nutzt Unzer e com GmbH?Zu der Unzer-Gruppe gehören zahlreiche Unternehmen; unter anderem die Heidelberger Payment sowie die Universum Group, mPAY24, StarTec, Avanti, Alpha Cash, ec-Plus, POSeidon digital, Pay Later (übernommen von Paysafe), Paydiscount. Kulam und Lavego. Im April 2022 übernahm Unzer zudem das Berliner Fintech Tillhub.
Wem gehört Unzer?Aus heidelpay wird Unzer. Das Unternehmen hat heute einen komplett neuen Markenauftritt vorgestellt.
Ist Unzer sicher?Mit Unzer bist Du bestens geschützt: vor Betrug, Zahlungsausfällen und Datenmissbrauch. Zum Beispiel prüfen wir die Bonität Deiner Käufer beim Bezahlen in Echtzeit.
Wo kann ich mit Unzer bezahlen?Unzer payments. |