FastBill Automatic. Dokumentation. Hosted Pages. FastBill GmbH. Holteyer Straße Essen Telefon Telefax

Transkript

1 FastBill GmbH Holteyer Straße Essen Telefon Telefax FastBill Automatic Dokumentation Hosted Pages 1

2 1. Grundlegendes Für einen reibungslosen und schnellen Buchungsprozess, sowie eine übersichtliche Abo und Kundenverwaltung stellen wir Ihnen unsere Hosted Pages bei FastBill Automatic zur Verfügung. Diese können einfach und flexibel in die eigenen Seiten eingebaut werden. So kann der Kunde die Produkte unkompliziert buchen, Produkte wechseln, Addons hinzufügen und vieles mehr. Darüber hinaus können Logo, Farben und Felder über den Style Editor angepasst werden. Im Folgenden wird aufgezeigt, welche Hosted Pages es bei FastBill Automatic gibt und wie diese funktionieren. 2. Das Buchungsformular Den Link zur Produktbuchung können Sie über das Symbol rechts in der Produktübersicht erreichen. Das Buchungsformular ist das wichtigste der Hosted Pages, da dem Interessenten so erstmals die Möglichkeit geboten wird, Kunde zu werden. Der Buchungsprozess besteht aus 3 Schritten: Schritt 1 Produkt und Rechnungsdaten Auf der ersten Seite sieht der Kunde eine kleine Übersicht des Produktes, welches er kaufen will, mit den dazugehörigen Infos (Warenkorb). Abhängig davon, was in den Produkteigenschaften eingestellt wurde, kann der Kunde optional die Anzahl der Produkte wählen. Ein weiteres optionales Feld ist das Rabattfeld. Bevor es im Buchungsformular angezeigt werden kann, müssen die entsprechenden Rabattcodes bei FastBill Automatic hinterlegt oder generiert werden. Zusätzlich muss die Option Gutscheine unter Einstellungen/Kommunikation/Hosted Pages/Rechnungsdaten aktiviert sein. 2

3 Der kleinen Produktübersicht folgen die auszufüllenden Felder für die Rechnungsdaten. An dieser Stelle werden Name und Adressdaten des Kunden abgefragt. Es gibt vordefinierte Pflichtfelder, welche über den Style Editor einstellbar sind. Das System erkennt die Besonderheiten der internationalen Steuergebung anhand der Daten und beachtet die gesetzlichen Vorgaben automatisch. (Nähere Informationen dazu bietet die Dokumentation Internationalisierung) Die Felder zum Newsletterempfang und einer abweichenden Lieferadresse können nach Wunsch eingeblendet werden. 3

4 4

5 Schritt 2 Die Zahlungsdaten Die zweite Seite des Buchungsformulars bieet die Möglichkeit Zahlungsdaten einzugeben. Auf dem Bild werden alle 4 Zahlungsarten dargestellt. Dabei werden nur die Zahlungsmöglichkeiten angezeigt, die in Ihrem FBA Account eingerichtet bzw. aktiviert wurden. Die Optionen Rechnung und Lastschrift sind standardmäßig aktiviert. Auf Wunsch können diese beiden Zahlungsoptionen unabhängig voneinander ausgeblendet werden. Die Deaktivierung erfolgt unter Konto Einstellungen > Einstellungen > Bezahlung > Interne Einstellungen. Bei Lastschriften handelt es sich um SEPA Lastschriften. Bei der Auswahl dieser Zahlungsart wird im Schritt 3 das SEPA Mandat zur Vorschau angeboten und muss vom Kunden bestätigt werden. Je nach Paymentdienstleister steht die SEPA Lastschrift nur für bestimmte Länder zur Verfügung. Bei einem kostenfreien Produkt kann der Schritt Zahlungsdaten ausgeschaltet werden. Für eine individuelle Beratung steht das FBA Produktteam gern zur Verfügung. Schritt 3 Die Bestätigung An dieser Stelle wird dem Endkunden eine Übersicht über seinen Warenkorb und seine Rechnungsdaten gegeben. 5

6 Zusätzlich befindet sich unten eine Checkbox für die Zustimmung zu den AGBs und der Datenschutzerklärung, sowie bei SEPA Lastschrift die Checkbox für das SEPA Mandat und der Link zur Mandatsvorschau. Letztere ist nur sichtbar wenn Lastschrift in den Zahlungseinstellungen aktiviert ist und als Mandat entweder ohne Unterschrift oder mit Unterschrift ausgewählt ist. Ohne Bestätigung von AGB und SEPA Mandat ist ein Kauf nicht möglich. Damit die Links für die AGB und die Datenschutzerklärung auch auf Ihre Dokumente leiten können, müssen die URLs in den Einstellungen hinterlegt sein (siehe S.15). Wenn der Kunde die Produktbuchung abgeschlossen hat, sollte er im besten Fall auf eine von Ihnen bestimmte Success URL weitergeleitet werden. Wenn die Produktbuchung abgebrochen wird, leitet das System zur hinterlegten Cancel URL um. 6

7 Beide URLs können in den Produkteinstellungen zu jedem Produkt individuell hinterlegt werden. Der Abbruch Button im Buchungsformular wird erst nach dem Hinterlegen einer Abbruch URL sichtbar. Hosted Page Link: Platzhalter: Produkt buchen ACCOUNT_HASH (siehe Einstellungen/Kommunikation/Hosted Pages) PRODUCT_ID (siehe Produkte/Nr. Code) Fallbeispiel: Ein Kunde will Ihr Produkt mit der Produktnummer p100 bestellen. Ihr Account Hash lautet z.b. b4779cf0b84e d66aad809. Der Link für das entsprechende Buchungsformular setzt sich folgendermaßen zusammen: b4779cf0b84e d66aad809 / p100 Ihren richtigen Account Hash finden Sie an folgender Stelle: Einstellungen/Kommunikation/Hosted Pages Der Account Hash in den Fallbeispielen dient immer nur als Beispiel Hash! 7

8 3. Die Zahlungsdaten ändern Um dem Kunden zu ermöglichen seine Rechnungsdaten und Zahlungsdaten zu ändern, bietet FastBill Automatic die Hosted Page Zahlungsdaten eines Kunden ändern an. In den URLs wird immer mit sogenannten Hashs gearbeitet, wie z.b. dem Costumer Hash oder dem Subscription Hash. Diese sind nicht zu verwechseln mit der Costumer ID und der Subscription ID. Entsprechende Hashs können Sie entweder über die API abfragen, oder Bei der Rückleitung nach erfolgreicher Buchung an die URL Erfolgsfall (kann bei jedem Produkt individuell eingestellt werden) werden die zwei Parameter gespeichert. (Achtung: In der Erfolgsfall URL steht zwar costumerid und subscriptionid, es handelt sich dennoch um die Hashes!) Da die Zahlungsdaten derzeit nicht von den Stammdaten getrennt sind, wird der Kunde über einen Zwischenschritt zu den Zahlungsdaten weitergeleitet: Nachdem der Kunde die Änderungen überprüft und gespeichert hat, bekommt er eine Bestätigungsmeldung. 8

9 Da bei dieser Hosted Page keine automatische Weiterleitung voreingestellt ist, können URLs für den Erfolg bzw. Abbruch des Änderns der Zahlungsdaten an das FBA Produktteam übermittelt werden. Der Abbruch Button im Buchungsformular wird erst nach dem Hinterlegen einer Abbruch URL sichtbar. Hosted Page: Zahlungsdaten ändern Link: Platzhalter: ACCOUNT_HASH (siehe Einstellungen/Kommunikation/Hosted Pages) COSTUMER_HASH (API bzw. Erfolgsfall URL) Fallbeispiel: Ein Kunde will seine Zahlungsdaten ändern. Der Kunde hat den Costumer Hash 92b9c44eadd513d81b79971cd87106 und Sie haben den Account Hash b4779cf0b84e d66aad809. Der Link würde dann folgendermaßen aussehen: 81b79971cd Neues Abo für einen bestehenden Kunden Wenn der Kunde ein neues Abo buchen will, gibt es dazu eine Hosted Page, in die die vorhandenen 9

10 Kundendaten vorausgefüllt werden. Diese wird auch über den Kunden Hash und diesmal auch die Produkt ID definiert. Die Produkt ID ist die frei wählbare Produktnummer. Diese Hosted Page beinhaltet den kompletten Buchungsprozess inklusive der Bestätigungsseite 3 Seite 1 und gegebenfalls Lastschriftdaten sind mit den Daten aus der Kundenakte vorausgefüllt. Hosted Page: Neues Abo für einen Kunden Link: Platzhalter: ACCOUNT_HASH (siehe Einstellungen/Kommunikation/Hosted Pages) COSTUMER_HASH (API bzw. Erfolgsfall URL) PRODUCT_ID (siehe Produkte/Nr. Code) Fallbeispiel: Ein Kunde will ein neues Produkt buchen. Der Kunde hat den Costumer Hash 92b9c44eadd513d81b79971cd87106 und Sie haben den Account Hash b4779cf0b84e d66aad809. Das Produkt hat die Product ID p100. Der Link würde dann folgendermaßen aussehen: (ACCOUNT_HASH) 92b9c44eadd513d81b79971cd87106 (COSTUMER_HASH) / p Produktwechsel Für diese Hosted Page werden der Subscription Hash und die Product ID benötigt. Die URLs, auf welche bei Erfolg bzw. Abbruch weitergeleitet werden soll, können an das FBA Produktteam übergeben werden. Wird nun die Produkt ID des Produktes, auf welches gewechselt werden soll, eingetragen, dann erfolgt 10

11 die Weiterleitung auf folgende Hosted Page: Hosted Page: Produkt wechseln Link: Platzhalter: ACCOUNT_HASH (siehe Einstellungen/Kommunikation/Hosted Pages) SUBSCRIPTION_HASH (API bzw. Erfolgsfall URL) PRODUCT_ID (siehe Produkte/Nr. Code) Fallbeispiel: Ein Kunde will ein neues Produkt buchen. Der Kunde hat den Subscription Hash 92b9c44eadd513d81b79971cd87106 und Sie haben den Account Hash b4779cf0b84e d66aad809. Das Produkt, auf welches er wechseln will hat die Product ID p200. Der Link würde dann folgendermaßen aussehen: 92b9c44eadd513d81b79971cd87106 (SUBSCRIPTION_HASH) / p200 (ACCOUNT_HASH) 11

12 6. Abo kündigen Diese Hosted Page ermöglicht es Abonnements zu kündigen. Nach dem Eintragen des Abo Hashs leitet diese URL direkt zum Kündigungsformular weiter: Das Abonnement wird zum nächsten Zahlungsevent bzw. im Rahmen der Kündigungsfrist gekündigt. Die URLs, auf welche bei Erfolg bzw. Abbruch weitergeleitet werden soll, können an das FBA Produktteam übergeben werden. Hosted Page: Abo kündigen Link: Platzhalter: ACCOUNT_HASH (siehe Einstellungen/Kommunikation/Hosted Pages) SUBSCRIPTION_HASH (API bzw. Erfolgsfall URL) Fallbeispiel: Ein Kunde will kündigen. Der Kunde hat den Subscription Hash 92b9c44eadd513d81b79971cd87106 und Sie haben den Account Hash b4779cf0b84e d66aad809. Der Link würde dann folgendermaßen aussehen: 12

13 (ACCOUNT_HASH) / 92b9c44eadd513d81b79971cd87106 (SUBSCRIPTION_HASH) 7. Kunden Dashboard Eine Hosted Page, die nicht in der Liste der Hosted Pages in FBA angezeigt wird, ist das Kunden Dashboard. In diesem kann der Kunden eine Übersicht über seine Daten, seine gebuchten Produkte etc. erhalten und diese gegebenenfalls ändern. Die Änderungslinks führen zu den oben genannten Hosted Pages. Je nach Wunsch kann ein personalisierter Login angeboten werden. Das bedeutet, dass jeder Kunde einen eigenen Benutzernamen und ein eigenes Passwort erhält, damit er sich in das Kunden Dashboard einzuloggen kann. Die Einrichtung im Account erfolgt in Zusammenarbeit mit dem FBA Produktteam. Die Login Daten bekommt jeder Kunde über die automatischen Mails zugesandt. Platzhalter für die Login Daten ermöglichen die dementsprechende Einrichtung der E Mails. (Für nähere Informationen: Dokumentation zu automatisierten E Mails.) In der Login Maske befindet sich zudem ein Button Passwort vergessen. Betätigt Ihr Kunde diesen Button, wird eine automatische E Mail mit seinem Passwort verschickt. Diese automatische E Mail ist ebenfalls individuell bearbeitbar. Außerdem besteht die Möglichkeit über den Backendzugang in der Kundenakte: Aktion ausführen.. > Kunden Dashboard auf dieses zuzugreifen: 13

14 Weiterhin wird das Ein und Ausblenden zusätzlicher Buttons, z.b. Kündigen, Daten ändern oder Produkt wechseln, ermöglicht. Für diese Einstellungen wenden Sie sich bitte an das FBA Produktteam. Eine URL für ein Dashboard stellt sich folgendermaßen zusammen: Hosted Page: Kunden Dashboard anzeigen Link: Platzhalter: ACCOUNT_HASH (siehe Einstellungen/Kommunikation/Hosted Pages) COSTUMER_HASH (API bzw. Erfolgsfall URL) Fallbeispiel: Ein Kunde mit der Costumer Hash 92b9c44eadd513d81b79971cd87106 kommt mit Hilfe Ihres Account Hash b4779cf0b84e d66aad809 über folgenden Link zu seinem Dashboard: 14

15 (ACCOUNT_HASH) / 92b9c44eadd513d81b79971cd87106 (COSTUMER_HASH) 8. Subscription Reactivate Wenn Sie ein gekündigtes Abo reaktivieren wollen, benutzen Sie diese Hosted Page. Die benötigten Hashs können entweder direkt über die API oder über die Notifications oder über die Rückleitungs URL bzw. Weiterleitungs URL der Produkte abgefragt werden. Nur gekündigte Abos können reaktiviert werden. Wenn das Kündigungsdatum in der Zukunft liegt, wird das Abonnement ohne Rechnungslauf aktiviert. Liegt das Kündigungsdatum hingegen in der Vergangenheit, dann wird es mit einem sofortigen Rechnungslauf aktiviert. Hosted Page: Abo reaktivieren Link: Platzhalter: ACCOUNT_HASH (siehe Einstellungen/Kommunikation/Hosted Pages) SUBSCRIPTION_HASH (API bzw. Erfolgsfall URL) Fallbeispiel: Sie wollen ein gekündigtes Abo wieder aktivieren. Ihr Account Hash lautet b4779cf0b84e d66aad809 und der Subscription Hash des zu reaktivierenden Abos lautet 92b9c44eadd513d81b79971cd87106 über folgenden Link zu seinem Dashboard: (ACCOUNT_HASH) 15

16 92b9c44eadd513d81b79971cd87106 (SUBSCRIPTION_HASH) 9. Add on Unter dieser Hosted Page können Add ons hinzugebucht oder gelöscht werden, sowie die Anzahl der Add ons für ein Basisprodukt geändert werden. Hosted Page: Add ons Link: Platzhalter: ACCOUNT_HASH (siehe Einstellungen/Kommunikation/Hosted Pages) SUBSCRIPTION_HASH (API bzw. Erfolgsfall URL) Fallbeispiel: Sie wollen die Add ons eines Abos bearbeiten. Ihr Account Hash lautet b4779cf0b84e d66aad809 und der Subscription Hash des zu reaktivierenden Abos lautet 92b9c44eadd513d81b79971cd87106 über folgenden Link zu seinem Dashboard: 92b9c44eadd513d81b79971cd87106 (SUBSCRIPTION_HASH) (ACCOUNT_HASH) 10. Der FastBill Automatic Style Editor Der FastBill Automatic Style Editor ermöglicht das Personalisieren der Hosted Pages. Er bietet folgende Funktionen: das Bestimmen der Felder, welche im Buchungsformular angezeigt werden, und der Pflichtfelder, welche der Kunde zwingend ausfüllen muss, das Festlegen, ob ein Gutschein Feld angezeigt wird und ob die Möglichkeit besteht, eine abweichende Lieferadresse einzutragen, das Hinterlegen der URLs für AGB und Datenschutz und 16

17 das Hochladen eigener CSS Templates (es können externe Links zu den CSS Sheets direkt in das dazugehörige Feld eingefügt werden (HTML Kopf)) Insgesamt bietet der Style Editor die Möglichkeit die Hosted Pages stärker zu individualisieren. Der Hosted Pages Style Editor befindet sich unter Einstellungen/Kommunikation/Hosted Pages. Unter dem Reiter Layout lassen sich verschiedene Einstellungen für das Layout festlegen: Oben beginnen die verschiedenen Uploadbereiche. Dort kann eine CSS Datei und ein Favicon, welches im Tab Balken des Browsers zu sehen sein wird, hochgeladen werden. HTML Header Hier werden z.b. Styles bzw. Libs sowohl im CSS als auch im JavaScript Format in Ihre Hosted Pages eingearbeitet. Auch die Integration von Scripts wie Conversion oder Countern erfolgt an dieser Stelle. Weiter unten lassen sich ein Logo hochladen sowie Einstellungen für den Header und den Footer treffen. 17

18 Header An dieser Stelle können Logos, verschiedene Icons oder einen kompletten Header für die Pages (im Stile der eigenen Webseite) eingefügt werden. Footer Im Fuß können verschiedene Googleadservices wie z.b. Conversion oder Tag Manager eingearbeitet werden. Ein Cookie Check ist hierüber auch möglich. Unter dem Reiter Rechnungdaten kann gestgelegt werden, welche aktiven Eingabefelder es in den Formularen geben soll. Es wird festgelegt, welche Eingabefelder angezeigt werden sollen und welche dieser Felder als Pflichtfelder markiert werden sollen. Außerdem finden Sie hier die Optionen um eine zusätzliche Lieferadresse und Gutscheine zu aktivieren. Unter dem Reiter Zahlungsdaten wird angegeben, welche Standard Zahlungsart Sie festlegen möchten. 18

19 Unter dem letzten Reiter AGB & Datenschutz werden die URLs zu den AGBs und einer Datenschutzerklärung hinterlegt werden. 11. Hosted Pages Parameter Zur Vereinfachung der Nutzung der Hosted Pages besteht vor dem Versand des Links die Möglichkeit kundenspezifische Daten hinzuzufügen. Dabei kann entweder die Hosted Page oder ihr Inhalt angepasst werden. Die Parameter mit der Abkürzung S füllen die Felder der Hosted Pages. Wenn durch Einsetzen des Parameter Änderungen welche für den Kunden nicht sichtbar sind oder welche die gesamte Hosted Page betreffen erfolgen, dann ist dies mit V abgekürzt. 1. Die Kundendaten Parameter Erklärung Beispiel address_line1 Adresse Bullway 13 S affiliate Affiliate Max Muster V city Ort Kuhtown S company Unternehmen Milchmann S country Land DE, FR, CH S customer_ext_number externe Kundennummer K 1513 V customer_ext_uid externe Kunden ID V E Mail Adresse j.smith@kalbmail.de S first name Vorname John S 19

20 language / lang übersetzt die gesamte Seite (& die Kundensprache im Backend wird angepasst) en, it, fr, es V last name Nachname Smith S newsletter Newsletter 1 V postal code Postleitzahl S salutation Anrede Herr S tags Tags reseller, berlin S telephone, phone Telefonnummer S title_academic Titel Dr. S vatid Umsatzsteuer ID DE S Die Parameter werden an die URL mit &parameter=value (z.b. &lang=es ) angefügt. 2. Die Abodaten Parameter Erklärung Beispiel product_description Produktbeschreibung trockenes Gras V productquantity Produktanzahl 7 V product_title Produkttitel Heu V promocode Rabattcode SummerSale S start Startdatum V subscription_ext_uid externe Abonnement ID V subscription_title Titel des Abonnements Heu Abo J. Smith V url_success URL für Erfolg der Abo Buchung olg.php Die Parameter werden an die URL mit &parameter=value (z.b. &lang=es ) angefügt. V 3. x Attribute, sec_token und check Parameter Erklärung Beispiel 20

21 check Um eine Manipulation der Parameter durch Kunden zu verhindern, kann man diese mit md5 und einem von FastBill festgelegten Salt verschlüsseln. Sollte die Checksumme nicht mit den Parametern übereinstimmen kann die Buchung nicht durchgeführt werden. ill.com/purchase/6a7c bd49249c07ed0bbe89 4c2ec8dfe3/BASIS L& start= &cu stomer_ext_uid= d33&check=a c018f005ff88c e sec_token Um die Sicherheit der Dauerlinks zu erhöhen, kann man über die API Links abfragen welche mit einen auf 10 min beschränkten Token versehen sind. Wenn der Token abgelaufen ist, kann man den Link nicht mehr aufrufen. ill.com/purchase/58c1 90f36c bec22 c5fe /1&sec_t oken=b b d602bc59dbdd5debb7 9 x key/x * = value X Attribute, individuell benennbar x Twitter, x Farbe, x Kleidergroesse, value = JSmith, M, rot V Die Parameter werden an die URL mit &parameter=value (z.b. &lang=es ) angefügt. Die einzige Ausnahme dabei sind die x Attribute. Sie werden mit &x_key=value (also z.b. & x_twitter=johnsmith) an die URL der Hosted Page angehängt. 21