Web-Gutscheine Landing Page
Sie können von den Hypersoft Web-Gutscheine Informationen abrufen und z.B. auf Ihrer Homepage anzeigen lassen.
Dieses Thema betrifft planungspflichtige Projektarbeit.
Das Hypersoft // System ist ein Standardprogramm, das in vielen verschiedenen Konfigurationen eingesetzt werden kann. Die korrekte Anwendung der hier beschriebenen Themen erfordert Expertenwissen und einen Abgleich der Erwartungen und nicht alle Hypersoft Mitarbeiter und Partner sind in allen so gekennzeichneten Themen gleichermaßen geschult. Aus diesem Grund kennzeichnen wir diese Themen als planungspflichtige Projektarbeit, damit Sie sich rechtzeitig mit dieser notwendigen Planung an Ihren Hypersoft Vertriebspartner oder den Hypersoft Support wenden können. Diese Vorgehensweise stellt sicher, dass wir Ihre Anforderungen entsprechend sorgfältig aufnehmen und zielorientiert beantworten.
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)
<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://webvoucher.mobile-people.de/
Beispiel mit Einladungsbetrag:
https://webvoucher.mobile-people.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 ausgebenecho '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 ausgebenif ($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:
3rd Party Gutschein Integration
Zurück zur übergeordneten Seite: MOBILE PEOPLE Anbindungen