Gutscheinaktionen mit individuellen Codes

Inhalt dieses Artikels
  1. Vorbemerkungen
  2. Individuellen Gutscheincode umsetzen

1. Vorbemerkungen

Bei der Erstellung einer Gutscheinaktion generiert plenigo einen sechsstelligen alphanumerischen Gutscheincode (z. B. AB1-C34-DE5). 
Wenn gewünscht, kann der Gutscheincode beispielsweise mit einem Wort ersetzt werden. Diese Funktion steht jedoch direkt im Merchant Backend nicht zur Verfügung. 
In diesem Eintrag wird beschrieben, wie dies trotzdem umgesetzt werden kann.

2. Individuellen Gutscheincode umsetzen

1. Erstellung Gutschein-Aktion im Merchant Backend
Zunächst muss die Gutscheinaktion im Merchant Backend erstellt werden. Es wird empfohlen, eine Mehrfachgutscheinaktion mit einem einzelnen Gutscheincode anzulegen. Der Gutscheincode wird von plenigo erstellt.

2. Landingpage zur Gutscheineinlösung
Für die Einlösung wird eine Landingpage benötigt. Eine Nutzung des Gutscheineinlösefelds im Checkout ist bei diesem Vorgehen nicht ratsam. Auf der Landingpage kann der Code in einem Feld eingetragen werden und über einen Button abgesendet werden. Über den Button wird rein technisch der Checkout aufgerufen. Das geschieht in diesem Fall mit dem API-Endpunkt https://api.plenigo-stage.com/api/v3.0/checkout/preparePurchase
Im Feld "voucherCode" kann nun das gewünschte Wort mitgegeben werden, z. B. "PROBEABO", das an Stelle des Gutscheincodes verwendet werden soll. Über das Flag "hideVoucherInput" kann das Gutscheineinlösefeld deaktiviert werden.
Mehr Informationen befindet sich in der API-Dokumentation.

3. Mapping 
Der eigentlich neue Schritt besteht nun in einem Mapping, das den externen Code (z. B. PROBEABO) dem internen Code der Gutscheinaktion (z. B. AB1-C34-DE5) zuweist. 
Dieses Mapping kann beispielsweise ein Skript sein, das die Eingabe des externen Codes prüft und in das plenigo System den korrespondierenden internen Code weitergibt. Wird keine Übereinstimmung gefunden, könnte zusätzlich eine Fehlermeldung ausgegeben werden.