Ist die Generische Gutscheinschnittstelle konfiguriert, werden von LINA POS die Anfragen an das Drittsystem gesandt und ausgeführt. Die Anfragen sind Gutschein-Validierung (Prüfung), Verkauf, Aufladung und Einlösung.
| Voraussetzung | Gutscheine konfiguriert |
| benötigte Lizenz | LINA Voucher |
Anfragen für Gutschein-Verkauf
Endpunkt:
<REDIRECT-URL>/purchase?api-key=<API-KEY>&amount=<AMOUNT>
GET-Parameter:
api-key | Der für den Gutscheinanbieter definierte API-KEY. |
amount | Die Brutto Höhe und somit das Startguthaben des verkauften Gutscheins. |
Von LINA erwartete Antwort wenn Anfrage verarbeitet wurde:
{ "token": "Valid", "tokencode": "GUTSCHEINCODE", "wert": 50.00 }
Feldname | JSON-Datentyp | Beschreibung |
token | String | Feld muss den Wert „Valid“ haben, wenn der Gutschein angelegt wurde und „Invalid“ wenn der Gutschein nicht angelegt wurde. |
tokencode | String | Der einzigartige Gutscheincode, der soeben für den verkauften Gutschein erzeugt wurde. |
wert | Float | Die Brutto Höhe und somit das Startguthaben des Gutscheinverkaufs. |
Von LINA erwartete Antwort, wenn Anfrage nicht verarbeitet werden konnte:
{ "token": "Invalid", "grund": "Gutschein konnte nicht erzeugt werden weil…" }
Feldname | JSON-Datentyp | Beschreibung |
token | String | Feld muss den Wert „Valid“ haben, wenn der Gutschein angelegt wurde und „Invalid“ wenn der Gutscheincode nicht angelegt wurde. |
grund | String | Freitextfeld für den Grund der Ablehnung. |
Anfragen für Gutschein-Prüfungen
Endpunkt:
<REDIRECT-URL>/checkcode?api-key=<API-KEY>&code=<GUTSCHEINCODE>
GET-Parameter:
api-key | Der für den Gutscheinanbieter definierte API-KEY. |
code | Der zu prüfende Gutscheincode |
Von LINA erwartete Antwort wenn Anfrage verarbeitet wurde:
{
"token": "Valid",
"tokencode": "GUTSCHEINCODE",
"startwert": 50.00,
"restwert": 12.50
}
Feldname | JSON-Datentyp | Beschreibung |
token | String | Feld muss den Wert „Valid“ haben, wenn Gutscheincode bekannt ist oder „Invalid“ wenn der Gutscheincode unbekannt ist. |
tokencode | String | Der soeben überprüfte Gutscheincode in unveränderter Form. |
startwert | Float | Der Ursprüngliche Brutto Gutscheinwert nach Kauf des Gutscheins. |
restwert | Float | Der noch verbleibende Restwerts des Gutscheines nach Abzug aller Einlösungen. |
Von LINA erwartete Antwort wenn Anfrage nicht verarbeitet werden konnte:
{ "token": "Invalid", "grund": "Gutschein konnte nicht angelegt werden weil…" }
Feldname | JSON-Datentyp | Beschreibung |
token | String | Feld muss den Wert „Valid“ haben, wenn Gutscheincode bekannt ist oder „Invalid“ wenn der Gutscheincode unbekannt ist. |
grund | String | Freitextfeld für den Grund der Ablehnung. |
Anfragen für Gutschein-Aufladungen
Endpunkt:
<REDIRECT-URL>/addvalue?api-key=<API-KEY>&code=<GUTSCHEINCODE>&amount=<AMOUNT>
GET-Parameter:
api-key | Der für den Gutscheinanbieter definierte API-KEY. |
code | Der aufzuladende Gutscheincode. |
amount | Die Brutto Höhe der Aufladung, um die der Gutscheinsaldo erhöht werden soll. |
Von LINA erwartete Antwort wenn Anfrage verarbeitet wurde:
{ "token": "Valid", "tokencode": "GUTSCHEINCODE", "wert_zuvor": 50.00, "wert_jetzt": 100.00 }
Feldname | JSON-Datentyp | Beschreibung |
token | String | Feld muss den Wert „Valid“ haben, wenn der Gutschein aufgeladen wurde und „Invalid“ wenn der Gutschein nicht aufgeladen wurde. |
tokencode | String | Der Gutscheincode der soeben aufgeladen wurde in unveränderter Form. |
wert_zuvor | Float | Die Brutto Höhe des Gutscheinwerts vor der Aufladung. |
wert_jetzt | Float | Die Brutto Höhe des Gutscheinwerts nach der Aufladung. |
Von LINA erwartete Antwort wenn Anfrage nicht verarbeitet werden konnte:
{ "token": "Invalid", "grund": "Gutschein konnte nicht aufgeladen werden weil…" }
Feldname | JSON-Datentyp | Beschreibung |
token | String | Feld muss den Wert „Valid“ haben, wenn der Gutschein aufgeladen wurde und „Invalid“ wenn der Gutschein nicht aufgeladen wurde. |
grund | String | Freitextfeld für den Grund der Ablehnung. |
Anfragen für Gutschein-Einlösungen
Endpunkt:
<REDIRECT-URL>/redeem?api-key=<API-KEY>&code=<GUTSCHEINCODE>&amount=<AMOUNT>
GET-Parameter:
api-key | Der für den Gutscheinanbieter definierte API-KEY. |
code | Der Gutscheincode, auf dem die Einlöse stattfinden soll. |
amount | Die Brutto Höhe des Betrags, der eingelöst werden soll. |
Von LINA erwartete Antwort, wenn Anfrage verarbeitet wurde:
{ "token": "Valid", "tokencode": "GUTSCHEINCODE", "wert_zuvor": 100.00, "wert_jetzt": 80.01 }
Feldname | JSON-Datentyp | Beschreibung |
token | String | Feld muss den Wert „Valid“ haben, wenn der Gutschein eingelöst werden konnte und „Invalid“ wenn der Gutschein nicht eingelöst wurde. |
tokencode | String | Der Gutscheincode, der soeben eingelöst wurde, in unveränderter Form. |
wert_zuvor | Float | Die Brutto Höhe des Gutscheinwerts vor der Einlösung. |
wert_jetzt | Float | Die Brutto Höhe des Gutscheinwerts nach der Einlösung. |
Von LINA erwartete Antwort wenn Anfrage nicht verarbeitet werden konnte:
{ "token": "Invalid", "grund": "Gutschein konnte nicht eingelöst werden weil…" }
Feldname | JSON-Datentyp | Beschreibung |
token | String | Feld muss den Wert „Valid“ haben, wenn der Gutschein eingelöst werden konnte und „Invalid“ wenn der Gutschein nicht eingelöst wurde. |
grund | String | Freitextfeld für den Grund der Ablehnung. |