Web-Gutscheine Landing Page

Sie können von den Hypersoft Web-Gutscheine Informationen abrufen und z.B. auf Ihrer Homepage anzeigen lassen.

Hinweis: Planungspflichtige Projektarbeit

Dieses Thema gehört zu den Bereichen, die eine detaillierte Projektplanung erfordern.

Das Hypersoft System ist eine flexible Standardlösung, die in vielfältigen Konfigurationen eingesetzt werden kann. Die korrekte Umsetzung der hier beschriebenen Funktionen setzt fachliches Expertenwissen sowie einen klaren Abgleich Ihrer Anforderungen und Erwartungen voraus.

Bitte beachten Sie, dass nicht alle Hypersoft Mitarbeiter oder Partner in jedem dieser gekennzeichneten Themenbereiche gleich umfassend geschult sind.

Aus diesem Grund kennzeichnen wir bestimmte Inhalte als „planungspflichtige Projektarbeit“. So möchten wir sicherstellen, dass Sie sich frühzeitig an Ihren Hypersoft Vertriebspartner oder den Hypersoft Support wenden, um die nötige Planung und Abstimmung vorzunehmen.

Diese strukturierte Vorgehensweise ermöglicht es uns, Ihre Anforderungen sorgfältig zu erfassen und zielgerichtet umzusetzen.

---

Weiterführende Dokumentation: Gutschein, Fremdgutscheine - Alle

Aktueller Saldo (auf Homepage)

Wenn Sie den Status des aktuellen Guthabens von Web-Gutscheinen anzeigen lassen wollen, so stellen wir Ihnen hierfür eine Schnittstelle zur Verfügung. Die Summe kann auch erst nach Eingabe eines Pins angezeigt werden, Standard ist ohne PIN.

Um die Gutschein-Daten aus dem Hypersoft-Portal auszulesen und auf einer Landingpage darzustellen wird die Schnittstelle mit folgender URL aufgerufen:

https://myhypersoft.de/mobile-people.aspx?KN=<Kundennummer>&P=<Kennwort>&GN=<Gutscheinnummer>&PIN=<Pin

(Sehen Sie aber auch: Web-Gutschein URL für Statusabfrage)

Die zu übergebenden Parameter sind:

<Kundennummer>	Die Kundennummer des Kunden bei Hypersoft. Dieser Parameter ist fest vorgegeben.
<Kennwort>	Das hinterlegte Schnittstellenkennwort des Kunden bei Hypersoft. Dieser Parameter ist fest vorgegeben.
<Gutscheinnummer>	Die 14-stellige Nummer des abzufragenden Gutscheins. Diese Nummer wird vom Kunden eingegeben oder als Parameter an Ihre Landingpage übergeben.
<Pin>	Die 4-stellige PIN des abzufragenden Gutscheins. Diese Nummer wird vom Kunden eingegeben oder als Parameter an Ihre Landingpage übergeben. Die Entscheidung ob ein PIN verwendet wird ist eine globale Systemeinstellung.

Die Schittstelle gibt ein JSON-Objekt mit allen relevanten Daten zum Gutschein zurück. Eine gültige URL mit Ihren Daten wäre z. B.:

https://myhypersoft.de/mobile-people.aspx?KN=xxxxxxxxx&P=xxxxxxxxxxxxxxxxxxxxxxxx&GN=49012072574964&PIN=7906

Beispiele der Landingpages...

https://landingpage-hypersoft.de/

Beispiel mit Einladungsbetrag:

https://landingpage-hypersoft.de/?HYGS=490100115203445625

Beispielcode...

<?php

echo '<br />';

// übergebene Gutscheinnummer mit angehängter PIN auslesen

// entweder über Query oder über Form

$GNPIN = $_GET['HYGS'];

if ($GNPIN == '') {

$GNPIN = $_POST['HYGS'];

}

// keine Gutscheinnummer übergeben?

if ($GNPIN == '') {

// dann Gutscheinnummer abfragen

echo '<form method="get">';

echo 'Gutscheinnummer eingeben: <input type="text" name="HYGS"><br>';

echo '<input type="submit" value="Gutscheinnummer abfragen">';

echo '</form>';

} else {

// Kontostand des gutscheins ausgeben

echo 'Gutschein-Nr.: '.$GNPIN.'<br />';

// PIN und Gutscheinnummer splitten

$PIN = substr($GNPIN, -4);

$GN = substr($GNPIN, 0, 14);

// feste Daten des Kunden

$KN = 'xxkdnrxx';

$P = 'xxxxpwxxxxxx';

// URL für die Abfrage mit SSL

$URL = 'https://myhypersoft.de/mobile-people.aspx?KN='.$KN.'&P='.$P.'&PIN='.$PIN.'&GN='.$GN;

//echo '$URL: '.$URL.'<br />';

// Daten als JSON abfragen und in ein assoziatives Array dekodieren

$seite = file_get_contents($URL);

$array = json_decode($seite, true);

//var_dump($array);

echo '<br />';

// nur wenn der Status = OK, dann ist die Abfrage in Ordnung

// ansonsten Fehler ausgeben

if ($array['Status'] != 'OK') {

echo 'Fehler: '.$array['Status'];

} else {

$Kontostand = number_format($array['Kontostand'], 2);

echo 'Kontostand: '.$Kontostand.' EUR';

}

}

?>

Weiterführende Dokumentation: Web-Gutscheine

Rabattkarten auf eigener Homepage registrieren

Wenn Sie Rabattkarten ausgeben, die so eingestellt sind, dass sich die Kunden zur Verwendung registrieren müssen, können Sie die Registrierung von Ihrer Homepage aus durchführen lassen. Hierfür stehen Ihnen Eingabefelder und Meldungen bereit. Beispiel einer Blanko Seite mit allen verfügbaren Feldern:

Beispiel...

<?php

echo '<br />';

// übergebene Gutscheinnummer mit angehängter PIN auslesen

// entweder über Query oder über Form

$GNPIN = $_GET['HYGS'];

if ($GNPIN == '') {

$GNPIN = $_POST['HYGS'];

}

// übergebene eMail-Adresse auslesen

// entweder über Query oder über Form

$mail = $_GET['mail'];

if ($mail == '') {

$mail = $_POST['mail'];

}

// keine Gutscheinnummer und keine Mail übergeben?

if (($GNPIN == '') || ($mail == '')) {

// dann Gutscheinnummer abfragen

echo '<form method="get">';

echo '<table>';

echo '<tr><td>Gutscheinnummer eingeben:</td><td><input type="text" name="HYGS"></td><tr>';

echo '<tr><td>eMail-Adresse eingeben:</td><td><input type="text" name="mail"></td><tr>';

echo '<tr><td>Name:</td><td><input type="text" name="Name"></td><tr>';

echo '<tr><td>Vorname:</td><td><input type="text" name="Vorname"></td><tr>';

echo '<tr><td>Anrede:</td><td><input type="text" name="Anrede"></td><tr>';

echo '<tr><td>Strasse:</td><td><input type="text" name="Strasse"></td><tr>';

echo '<tr><td>PLZ:</td><td><input type="text" name="PLZ"></td><tr>';

echo '<tr><td>Ort:</td><td><input type="text" name="Ort"></td><tr>';

echo '<tr><td>Land:</td><td><input type="text" name="Land"></td><tr>';

echo '<tr><td>Telefon:</td><td><input type="text" name="Telefon"></td><tr>';

echo '</table>';

echo '<br>';

echo '<input type="submit" value="Gutschein aktivieren.">';

echo '</form>';

} else {

// Fehler oder positive Meldung ausgeben

echo 'Gutschein-Nr.: '.$GNPIN.'<br />';

echo 'eMail-Adresse: '.$mail.'<br />';

echo 'Name: '.$_GET['Name'].'<br />';

echo 'Vorname: '.$_GET['Vorname'].'<br />';

echo 'Anrede: '.$_GET['Anrede'].'<br />';

echo 'Strasse: '.$_GET['Strasse'].'<br />';

echo 'PLZ: '.$_GET['PLZ'].'<br />';

echo 'Ort: '.$_GET['Ort'].'<br />';

echo 'Land: '.$_GET['Land'].'<br />';

echo 'Telefon: '.$_GET['Telefon'].'<br />';

$Kundendaten = urlencode($_GET['Name'].'|'.$_GET['Vorname'].'|'.$_GET['Anrede'].'|'.$_GET['Strasse'].'|'.$_GET['PLZ'].'|'.$_GET['Ort'].'|'.$_GET['Land'].'|'.$_GET['Telefon']);

// PIN und Gutscheinnummer splitten

$PIN = substr($GNPIN, -4);

$GN = substr($GNPIN, 0, 14);

// feste Daten des Kunden

//$KN = 'xxxxx';

$KN = 'yyyyy';

$P = 'Passxyzword';

// URL für die Abfrage mit SSL

$URL = 'https://myhypersoft.de/mobile-people-special-cards.aspx?KN='.$KN.'&P='.$P.'&PIN='.$PIN.'&GN='.$GN.'&M='.$mail.'&KD='.$Kundendaten;

//echo '$URL: '.$URL.'<br />';

// Daten als JSON abfragen und in ein assoziatives Array dekodieren

$seite = file_get_contents($URL);

$array = json_decode($seite, true);

//var_dump($array);

echo '<br />';

// nur wenn der Status = OK, dann ist die Abfrage in Ordnung

// ansonsten Fehler ausgeben

if ($array['Status'] != 'OK') {

echo 'Fehler: '.$array['Status'];

} else {

echo 'Danke für Ihre Aktivierung!<br />Zur Bestätigung wurde eine Mail an Ihre eingegebene eMail-Adresse gesendet. Bitte bestätigen Sie den Aktivierungslink in dieser eMail, danach können Sie sofort den Rabattgutschein einsetzen.';

}

}

?>

---

Weiterführende Dokumentation:

Web-Gutscheine Rabattkarten

3rd Party Gutschein Integrationen

Zurück zur übergeordneten Seite: MOBILE PEOPLE Anbindungen