eCash - CouponData mass redemption
Fragestellungen:
- Wie kann man Gutscheindaten gesammelt einlösen?
- Wie kann man Gutscheindaten in großen Mengen einlösen?
Beschreibung:
TYRIOS eCash macht es möglich, Coupons (Coupon-Daten) in Massen einzulösen. Dies ist auch über unsere API möglich.
Achtung
Wenn TYRIOS eCash mit digitalen Coupons angewendet wird, wird dringend empfohlen, die Coupons über den Point-of-Sales-Service einzulösen! Es ist wichtig zu prüfen, welche Datenmenge auf einem digitalen Coupon noch verfügbar ist, wenn der Coupon als Zahlungsoption akzeptiert wird. Digitale Coupons können teilweise eingelöst werden.
Überprüfung eines Coupons
TYRIOS bietet dir die Möglichkeit zu überprüfen, ob ein Coupon eingelöst werden kann und wie hoch der aktuelle Wert ist.
Endpunkt für die GET-Anfrage:
https://tyrios-instance.cloud/service/BonusPointManagement/CouponDataMassSubmit/CouponData/[couponCode]
der Coupon wird sofort überprüft. Wenn er nicht gültig ist, erhältst du eine detaillierte Fehlermeldung mit dem Unternehmen, das für das CouponData-Objekt verantwortlich war:
{ message: "detailed message", company: {id: 6, companyName: "...", street: "...", streetNo: "...", postCode: "...", city: "...",...}
Wenn der Coupon gültig ist, erhältst du die entsprechenden Coupondaten als Information.
{couponCode: "AB4DEFGH", couponValue: 50, validUntil: 1672527600000
Massenübermittlung von Coupondaten
Um eine große Menge an Gutscheinen einzulösen, musst du eine POST-Anfrage an folgende URL senden:
https://tyrios-instance.cloud/service/BonusPointManagement/CouponDataMassSubmit
Als Payload musst du die folgende Datenstruktur als JSON-Body senden:
{ couponCodes: ["ABCDEFGH", "ABCDEFGI, ....] }
Alle bereitgestellten CouponCodes werden validiert und bei dem entsprechenden Unternehmen eingelöst. Wenn alles richtig funktioniert, erhältst du eine 200-Status-Antwort mit body:
{"status"=>"created"}
Wenn ein Coupon ungültig ist, erhältst du eine entsprechende Fehlermeldung. Wir empfehlen jedoch, jeden Coupon einzeln zu validieren, um dem Nutzer beim Scannen der Coupon-Codes einen Gesamtbetrag präsentieren zu können.
Bitte beachte, dass bei der Masseneinlösung der Gutscheinwert feststeht und vom Nutzer nicht geändert werden kann.