Web Vouchers Landing Page

You can retrieve information from the Hypersoft web vouchers and display it on your homepage, for example.

This topic concerns project work that is subject to planning.

The Hypersoft // system is a standard programme that can be used in many different configurations. The correct application of the topics described here requires expert knowledge and an alignment of expectations, and not all Hypersoft employees and partners are equally trained in all of the topics labelled in this way. For this reason, we characterise these topics as project work requiring planning, so that you can contact your Hypersoft sales partner or Hypersoft Support in good time with this necessary planning. This approach ensures that we record your requirements carefully and respond to them in a targeted manner.

Further documentation: Vouchers, third-party vouchers - All

Current balance (on homepage)

If you want to display the status of the current credit balance of web vouchers, we provide you with an interface for this. The sum can also only be displayed after entering a pin, the default is without PIN.

To read the voucher data from the Hypersoft portal and display it on a landing page, the interface is called up with the following URL:

https://myhypersoft.de/mobile-people.aspx?KN=<Customer number>&P=<Password>&GN=<Voucher number>&PIN=<Pin

(But see also: Web voucher URL for status request)

The parameters to be passed are:

<Customer number>	The customer number of the customer at Hypersoft. This parameter is fixed.
<Password>	The customer's stored interface password at Hypersoft. This parameter is fixed.
<voucher number>	The 14-digit number of the voucher to be queried. This number is entered by the customer or passed as a parameter to your landing page.
<Pin>	The 4-digit PIN of the voucher to be queried. This number is entered by the customer or passed as a parameter to your landing page. The decision whether to use a PIN is a global system setting.

The interface returns a JSON object with all relevant data for the voucher. A valid URL with your data would be for example:

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

Examples of the landing pages...

https://landingpage-hypersoft.de/

Example with invitation amount:

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

Example code...

<?php

echo '<br />';

// Read out transferred voucher number with attached PIN

// either via query or via form

$GNPIN = $_GET['HYGS'];

if ($GNPIN == '') {

$GNPIN = $_POST['HYGS'];

// no voucher number handed over?

if ($GNPIN == '') {

// then ask for voucher number

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

echo 'Enter coupon number: <input type="text" name="HYGS"><br>'; echo '<input

type="submit" value="Query coupon number">'; 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';

?>

Further documentation: Web-Vouchers

If you issue discount cards that are set up to require customers to register for use, you can register from your home page. Input fields and messages are available for this purpose. Example of a blank page with all available fields:

Example...

<?php

echo '<br />';

// Read out transferred voucher number with attached PIN

// either via query or via form

$GNPIN = $_GET['HYGS'];

if ($GNPIN == '') {

$GNPIN = $_POST['HYGS'];

// read out the e-mail address transferred

// either via query or via form

$mail = $_GET['mail'];

if ($mail == ''') {

$mail = $_POST['mail'];

// no voucher number and no mail?

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

// then ask for voucher number

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

echo '<table>';

echo '<tr><td>Enter coupon number:</td><td><input type="text" name="HYGS"></td><tr>';

echo '<tr><td>Enter e-mail address:</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>firstname:</td><td><input type="text" name="firstname"></td><tr>';

echo '<tr><td>Education:</td><td><input type="text" name="Form of address"></td><tr>';

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

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

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

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

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

echo '</table>';

echo '<br>';

echo '<input type="submit" value="Activate coupon.">';

echo '</form>';

} else {

// Output error or positive message

echo 'coupon no.: '.$GNPIN.'<br />';

echo 'Email address: '.$mail.'<br />';

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

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

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

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

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

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

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

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

$Customer data = urlencode($_GET['Name'].'|'.$_GET['First name'].'|'.$_GET['Salutation'].'|'.$_GET['Street'].'|'.$_GET['Postcode'].'|'.$_GET['City'].'|'.$_GET['Country'].'|'.$_GET['City'].'|'.$_GET['City'].'|'.$_GET['Country'].'|'.$_GET['First name'].'|'.$_GET['City'].'||'.$_GET['City'];

// Split PIN and voucher number

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

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

// fixed data of the customer

//$KN = 'xxxxx';

$KN = 'yyyyy';

$P = 'Passxyzword';

// URL for the query with SSL

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

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

// Query data as JSON and decode it into an associative array

$page = file_get_contents($URL);

$array = json_decode($page, true);

//var_dump($array);

echo '<br />';

// only if the status = OK, then the query is OK

// otherwise output error

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

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

} else {

echo 'Thank you for your activation!<br />A confirmation email has been sent to the email address you entered. Please confirm the activation link in this email, then you can immediately use the discount voucher.';

?>

Further documentation:

Web Vouchers Discount Cards

3rd party voucher integration

Back to the parent page: MOBILE PEOPLE connections