@kreiseck/kasseneck-api 0.18.0 → 0.19.0

package/dist/cjs/payments/hobex-hps/transaction-response.js

@@ -26,10 +26,21 @@
  * bis dahin unbenannter Code ([TECHNICAL_ERROR_CODE], `9900`) war darueber
  * schluessig und haette eine Zahlung, unter der tatsaechlich Geld geflossen
  * sein kann, als `declined` gemeldet.
+ *
+ * Seit 16.09.2026 kommt die TECS-Liste dazu (`tecs-codes.ts`): das HPS
+ * reicht die Codes der TECS-Plattform durch, auf der hobex autorisiert. Neu
+ * sind dabei [HpsCode.sendReversal] (Storno nachschicken, siehe
+ * `payments.ts`) und die Schreibweise: TECS fuehrt `0055`, das Terminal
+ * sendet `55` -- [normalizeHpsCode] macht beides zu einem Code.
+ *
+ * **Einen neuen Code aufnehmen:** Eintrag hier oder in `tecs-codes.ts`,
+ * derselbe im Dart-Zwilling, `npm run fixtures:hobex-hps-codes`; ein neuer
+ * Grund braucht in jeder Kasse eine Uebersetzung.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NOT_FOUND_HTTP_STATUS = exports.TERMINAL_BUSY_HTTP_STATUS = exports.INTERNAL_ERROR_CODE = exports.TERMINAL_BUSY_CODE = exports.HOST_TIMEOUT_REVERSED_CODE = exports.TIP_SELECTION_FAILED_CODE = exports.UNSUPPORTED_USER_DATA_CODE = exports.CHIP_DATA_MISMATCH_CODE = exports.REFUND_DISABLED_CODE = exports.COMPLETION_FAILED_CODE = exports.INVALID_MESSAGE_TYPE_CODE = exports.TERMINAL_BLOCKED_CODE = exports.PASSWORD_NOT_ENTERED_CODE = exports.REFUND_PASSWORD_INVALID_CODE = exports.SCEP_ENROLLMENT_FAILED_CODE = exports.CARD_NOT_SUPPORTED_CODE = exports.CARD_DECLINED_CODE = exports.CARD_INFO_NOT_ENTERED_CODE = exports.DIAGNOSIS_FAILED_CODE = exports.MAX_RETRIES_EXCEEDED_CODE = exports.NOT_FOUND_CODE = exports.INVALID_TX_TYPE_CODE = exports.INVALID_TID_DOCUMENTED_CODE = exports.HOST_STEP_FAILED_CODE = exports.HOST_COMMUNICATION_FAILED_CODE = exports.APP_SELECT_FAILED_CODE = exports.CARD_READ_FAILED_CODE = exports.BAD_REQUEST_CODE = exports.WRONG_PIN_CODE = exports.INVALID_TID_CODE = exports.AMOUNT_OUT_OF_RANGE_CODE = exports.INVALID_AMOUNT_CODE = exports.NOT_ABORTABLE_CODE = exports.CARD_NOT_PRESENT_CODE = exports.ABORTED_CODE = exports.TECHNICAL_ERROR_CODE = exports.NO_STATEMENT_CODE = exports.TRANSACTION_CANCELED_CODE = exports.INVALID_TRANSACTION_CODE = exports.APPROVED_CODE = exports.HPS_MEASURED_CODES = exports.HPS_CODES = exports.HPS_REASON_HINTS = void 0;
 exports.isHostUncertainReason = isHostUncertainReason;
+exports.normalizeHpsCode = normalizeHpsCode;
 exports.hpsCodeInfo = hpsCodeInfo;
 exports.hpsCodeReason = hpsCodeReason;
 exports.parseHpsTransactionResponse = parseHpsTransactionResponse;
@@ -42,66 +53,75 @@ exports.isCanceled = isCanceled;
 exports.isConclusive = isConclusive;
 exports.isConclusiveAsStatus = isConclusiveAsStatus;
 exports.isHostUncertain = isHostUncertain;
+exports.needsReversal = needsReversal;
 exports.isUnknownCode = isUnknownCode;
+const tecs_codes_js_1 = require("./tecs-codes.js");
 /** Der Satz fuer den Bediener je Grund, deutsch. */
 exports.HPS_REASON_HINTS = {
     approved: 'Vom Terminal genehmigt.',
+    approvedWithCondition: 'Das Terminal meldet eine Genehmigung mit Vorbehalt (etwa nur über einen Teilbetrag). Ob und in welcher Höhe belastet wurde, bitte am Terminalbeleg prüfen — nicht erneut kassieren, bevor es geklärt ist.',
     aborted: 'Der Vorgang wurde abgebrochen. Es wurde kein Geld bewegt.',
-    noCard: 'Es wurde keine Karte vorgehalten. Es wurde kein Geld bewegt — '
-        + 'bitte erneut versuchen.',
-    cardReadFailed: 'Die Karte konnte nicht gelesen werden. Es wurde kein Geld bewegt — '
-        + 'bitte erneut versuchen, notfalls die Karte stecken statt auflegen.',
-    cardDeclined: 'Die Karte wurde vom Terminal abgelehnt. Es wurde kein Geld bewegt '
-        + '— bitte eine andere Karte oder Zahlungsart verwenden.',
-    wrongPin: 'Die PIN war falsch. Es wurde kein Geld bewegt — bitte erneut '
-        + 'versuchen.',
-    amountInvalid: 'Das Terminal nimmt diesen Betrag nicht an. Es wurde kein Geld '
-        + 'bewegt.',
-    tipNotSelected: 'Das Trinkgeld wurde nicht rechtzeitig gewählt. Es wurde kein Geld '
-        + 'bewegt — bitte erneut versuchen.',
-    terminalBusy: 'Das Terminal ist noch mit einem anderen Vorgang beschäftigt. Es '
-        + 'wurde kein Geld bewegt — kurz warten und erneut versuchen.',
-    terminalBlocked: 'Das Terminal ist gesperrt. Es wurde kein Geld bewegt — bitte hobex '
-        + 'kontaktieren.',
-    terminalSetup: 'Das Terminal ist nicht richtig eingerichtet. Es wurde kein Geld '
-        + 'bewegt — bitte die Terminal-ID in den Einstellungen prüfen, sonst '
-        + 'hobex kontaktieren.',
-    terminalFault: 'Das Terminal meldet eine Störung. Es wurde kein Geld bewegt — '
-        + 'bitte das Terminal neu starten und erneut versuchen.',
-    requestRejected: 'Das Terminal hat die Anfrage abgewiesen. Es wurde kein Geld bewegt '
-        + '— tritt das wieder auf, bitte den Support kontaktieren.',
-    invalidTransaction: 'Das Terminal kennt die ursprüngliche Zahlung nicht. Es wurde kein '
-        + 'Geld bewegt.',
-    refundPassword: 'Das Passwort für die Gutschrift war falsch oder wurde nicht '
-        + 'eingegeben. Es wurde nichts ausgezahlt.',
-    refundDisabled: 'Gutschriften sind an diesem Terminal abgeschaltet. Es wurde nichts '
-        + 'ausgezahlt — bitte hobex kontaktieren.',
-    hostTimeoutReversed: 'hobex hat nicht rechtzeitig geantwortet, das Terminal hat den '
-        + 'Vorgang selbst storniert. Es wird kein Geld bewegt — bitte erneut '
-        + 'versuchen.',
-    hostFault: 'Die Verbindung zwischen Terminal und hobex ist gestört. Ob die '
-        + 'Karte belastet wurde, weiß das Terminal nicht — bitte nicht erneut '
-        + 'kassieren, bevor es geklärt ist.',
-    internalError: 'Das Terminal meldet einen internen Fehler. Ob die Karte belastet '
-        + 'wurde, ist unklar — bitte nicht erneut kassieren, bevor es geklärt '
-        + 'ist.',
+    noCard: 'Es wurde keine Karte vorgehalten. Es wurde kein Geld bewegt — bitte erneut versuchen.',
+    cardReadFailed: 'Die Karte konnte nicht gelesen werden. Es wurde kein Geld bewegt — bitte erneut versuchen, notfalls die Karte stecken statt auflegen.',
+    cardDeclined: 'Die Karte wurde vom Terminal abgelehnt. Es wurde kein Geld bewegt — bitte eine andere Karte oder Zahlungsart verwenden.',
+    issuerDeclined: 'Die Zahlung wurde von der Bank abgelehnt. Es wurde kein Geld bewegt — bitte eine andere Karte oder Zahlungsart verwenden.',
+    cardBlocked: 'Die Karte ist gesperrt. Es wurde kein Geld bewegt — bitte eine andere Karte oder Zahlungsart verwenden.',
+    cardExpired: 'Die Karte ist abgelaufen. Es wurde kein Geld bewegt — bitte eine andere Karte oder Zahlungsart verwenden.',
+    insufficientFunds: 'Das Konto ist nicht gedeckt oder das Kartenlimit ist erreicht. Es wurde kein Geld bewegt — bitte eine andere Karte oder Zahlungsart verwenden.',
+    wrongPin: 'Die PIN war falsch. Es wurde kein Geld bewegt — bitte erneut versuchen.',
+    pinTriesExceeded: 'Die PIN wurde zu oft falsch eingegeben. Es wurde kein Geld bewegt — bitte eine andere Karte oder Zahlungsart verwenden.',
+    pinRequired: 'Die Bank verlangt die PIN. Es wurde kein Geld bewegt — bitte erneut versuchen, die Karte stecken und die PIN eingeben.',
+    amountInvalid: 'Das Terminal nimmt diesen Betrag nicht an. Es wurde kein Geld bewegt.',
+    tipNotSelected: 'Das Trinkgeld wurde nicht rechtzeitig gewählt. Es wurde kein Geld bewegt — bitte erneut versuchen.',
+    terminalBusy: 'Das Terminal ist noch mit einem anderen Vorgang beschäftigt. Es wurde kein Geld bewegt — kurz warten und erneut versuchen.',
+    terminalBlocked: 'Das Terminal ist gesperrt. Es wurde kein Geld bewegt — bitte hobex kontaktieren.',
+    terminalSetup: 'Das Terminal ist nicht richtig eingerichtet. Es wurde kein Geld bewegt — bitte die Terminal-ID in den Einstellungen prüfen, sonst hobex kontaktieren.',
+    acquirerSetup: 'hobex nimmt dieses Terminal oder diesen Händler so nicht an. Es wurde kein Geld bewegt — bitte hobex kontaktieren.',
+    terminalFault: 'Das Terminal meldet eine Störung. Es wurde kein Geld bewegt — bitte das Terminal neu starten und erneut versuchen.',
+    requestRejected: 'Das Terminal hat die Anfrage abgewiesen. Es wurde kein Geld bewegt — tritt das wieder auf, bitte den Support kontaktieren.',
+    hostRejected: 'hobex hat die Zahlung abgewiesen. Es wurde kein Geld bewegt — bitte erneut versuchen; tritt das wieder auf, hobex kontaktieren.',
+    hostUnavailable: 'Die Bank oder hobex ist gerade nicht erreichbar. Es wurde kein Geld bewegt — bitte später erneut versuchen oder eine andere Zahlungsart verwenden.',
+    invalidTransaction: 'Das Terminal kennt die ursprüngliche Zahlung nicht. Es wurde kein Geld bewegt.',
+    refundPassword: 'Das Passwort für die Gutschrift war falsch oder wurde nicht eingegeben. Es wurde nichts ausgezahlt.',
+    refundDisabled: 'Gutschriften sind an diesem Terminal abgeschaltet. Es wurde nichts ausgezahlt — bitte hobex kontaktieren.',
+    refundRejected: 'Die Gutschrift wurde abgewiesen (Betrag zu hoch, bereits erstattet oder zu viele Versuche). Es wurde nichts ausgezahlt.',
+    hostTimeoutReversed: 'hobex hat nicht rechtzeitig geantwortet, das Terminal hat den Vorgang selbst storniert. Es wird kein Geld bewegt — bitte erneut versuchen.',
+    reversedByHost: 'Die Zahlung wurde wegen einer Störung automatisch storniert. Es wurde kein Geld bewegt — bitte erneut versuchen.',
+    voidedAfterHostFault: 'hobex hat nicht sauber geantwortet, die Zahlung wurde deshalb sicherheitshalber storniert. Es wurde kein Geld bewegt — bitte erneut versuchen.',
+    hostFault: 'Die Verbindung zwischen Terminal und hobex ist gestört. Ob die Karte belastet wurde, weiß das Terminal nicht — bitte nicht erneut kassieren, bevor es geklärt ist.',
+    hostTimeout: 'hobex hat nicht rechtzeitig geantwortet. Ob die Karte belastet wurde, weiß das Terminal nicht — bitte nicht erneut kassieren, bevor es geklärt ist.',
+    internalError: 'Das Terminal meldet einen internen Fehler. Ob die Karte belastet wurde, ist unklar — bitte nicht erneut kassieren, bevor es geklärt ist.',
     canceled: 'Die Zahlung ist aufgehoben.',
-    notAbortable: 'Der Vorgang ist bereits abgeschlossen und lässt sich nicht mehr '
-        + 'abbrechen.',
+    cancelDenied: 'Die Zahlung lässt sich nicht mehr aufheben und bleibt belastet — bitte stattdessen eine Gutschrift ausführen.',
+    originalDeclined: 'Die ursprüngliche Zahlung war abgelehnt; es gibt nichts aufzuheben.',
+    notAbortable: 'Der Vorgang ist bereits abgeschlossen und lässt sich nicht mehr abbrechen.',
     noStatement: 'Das Terminal hat zu diesem Vorgang keine Auskunft.',
-    technicalError: 'Das Terminal meldet einen technischen Fehler; über den Vorgang '
-        + 'sagt das nichts.',
+    technicalError: 'Das Terminal meldet einen technischen Fehler; über den Vorgang sagt das nichts.',
     unknown: 'Das Terminal nennt einen Code, dessen Bedeutung nicht bekannt ist.',
 };
 /**
- * Die beiden Gruende hinter einem Code mit `effect: 'hostUncertain'`: ob Geld
- * geflossen ist, weiss das Terminal nicht.
+ * Die Gruende hinter einem Code mit `effect: 'hostUncertain'`: ob (und wie
+ * viel) Geld geflossen ist, weiss das Terminal nicht.
  */
 function isHostUncertainReason(reason) {
-    return reason === 'hostFault' || reason === 'internalError';
+    return reason === 'approvedWithCondition'
+        || reason === 'hostFault'
+        || reason === 'hostTimeout'
+        || reason === 'internalError';
 }
-function code(c, title, meaning, effect, reason, source, rejectsRequest = false) {
-    return { code: c, title, meaning, conclusive: effect === 'conclusive', effect, reason, source, rejectsRequest };
+function code(c, title, meaning, effect, reason, source, rejectsRequest = false, extra = {}) {
+    return {
+        code: c,
+        title,
+        meaning,
+        conclusive: effect === 'conclusive',
+        effect,
+        reason,
+        source,
+        rejectsRequest,
+        sendReversal: extra.sendReversal ?? false,
+        tecsTitle: extra.tecsTitle ?? null,
+    };
 }
 /**
  * Die vollstaendige Codetabelle — Vertrag mit dem Dart-Zwilling
@@ -126,19 +146,20 @@ function code(c, title, meaning, effect, reason, source, rejectsRequest = false)
  * dokumentierten aufsteigend -- identisch mit dem Dart-Zwilling.
  */
 exports.HPS_CODES = [
-    code('0', 'Authorized', 'genehmigt', 'conclusive', 'approved', 'measuredAndDocumented'),
+    code('0', 'Authorized', 'genehmigt', 'conclusive', 'approved', 'measuredAndDocumented', false, { tecsTitle: 'Approved Transaction / OK' }),
     code('9002', 'Invalid Transaction', 'ungueltiger Vorgang -- das Terminal hat den Vorgang selbst als '
-        + 'unzulaessig verworfen, bevor irgendetwas in Bewegung kam', 'conclusive', 'invalidTransaction', 'measured', true),
+        + 'unzulaessig verworfen, bevor irgendetwas in Bewegung kam', 'conclusive', 'invalidTransaction', 'measuredAndDocumented', true, { tecsTitle: 'Invalid Transaction' }),
     code('9011', 'Transaction Canceled', 'aufgehoben ("Transaction Canceled") -- der Vorgang unter dieser '
-        + 'Kennung wurde storniert', 'conclusive', 'canceled', 'measured'),
+        + 'Kennung wurde storniert', 'conclusive', 'canceled', 'measuredAndDocumented', false, { tecsTitle: 'Transaction cancelled' }),
     code('9027', 'Original Tx not found', 'keine Aussage -- steht gleichermassen fuer "nie gesehen", "laeuft '
-        + 'gerade", "Karte nicht aufgelegt" und "abgebrochen"', 'noStatement', 'noStatement', 'measured'),
+        + 'gerade", "Karte nicht aufgelegt" und "abgebrochen"', 'noStatement', 'noStatement', 'measuredAndDocumented', false, { tecsTitle: 'Original Transaction not found' }),
     code('9900', 'Technical Error Database', '"Technical Error Database" -- gemessen im Zusammenhang mit einer '
-        + 'nicht rein numerischen Kennung; keine Aussage ueber den Vorgang '
-        + 'selbst', 'noStatement', 'technicalError', 'measured'),
+        + 'nicht rein numerischen Kennung, NACHDEM die Karte verarbeitet war; '
+        + 'laut TECS ein Datenbankfehler im Backend -- ob belastet wurde, ist '
+        + 'offen', 'hostUncertain', 'internalError', 'measuredAndDocumented', false, { tecsTitle: 'Technical Error: Database (General)' }),
     code('9003', 'Invalid Amount', '"Invalid Amount" -- der Betrag wird abgewiesen, BEVOR eine Karte '
         + 'verlangt wird (28.08.2026: 99999,99 EUR, Antwort nach 15,7 s ohne '
-        + 'Kartenaufforderung); nichts belastet', 'conclusive', 'amountInvalid', 'measured'),
+        + 'Kartenaufforderung); nichts belastet', 'conclusive', 'amountInvalid', 'measuredAndDocumented', false, { tecsTitle: 'Invalid Amount' }),
     code('100002', 'Aborted', 'abgebrochen ("Aborted") -- ueber die Kasse oder am Terminal; '
         + 'nichts belastet', 'conclusive', 'aborted', 'measuredAndDocumented'),
     code('100003', 'Card not present', 'Karte nicht aufgelegt ("Card not present") -- innerhalb der Frist '
@@ -153,7 +174,7 @@ exports.HPS_CODES = [
         + 'gemessene Host-Ablehnung ueberhaupt (02.09.2026 im Betrieb, TID '
         + '3556988, HPS 1.11.4, Firmware 2.3.9): die Zahlung antwortete '
         + 'direkt damit, die Statusabfrage danach elfmal in Folge ebenso -- '
-        + 'eine Host-Ablehnung bleibt am Terminal abrufbar; nichts belastet', 'conclusive', 'wrongPin', 'measured'),
+        + 'eine Host-Ablehnung bleibt am Terminal abrufbar; nichts belastet', 'conclusive', 'wrongPin', 'measuredAndDocumented', false, { tecsTitle: 'Incorrect PIN' }),
     // ---- ab hier: Antwortcodeliste von hobex, erhalten 11.09.2026 ----
     code('100001', 'Bad Request', 'fehlerhafte Anfrage der Kasse ("Bad Request") -- Abweisung vor dem '
         + 'Kartenfluss; nichts belastet', 'conclusive', 'requestRejected', 'documented', true),
@@ -165,10 +186,10 @@ exports.HPS_CODES = [
         + 'Betrieb danach dauerhaft 9027; nichts belastet', 'conclusive', 'cardReadFailed', 'documented'),
     code('100006', 'Communication with TecsXml failed', 'keine Verbindung zum hobex-Host ("Communication with TecsXml '
         + 'failed") -- das Terminal storniert NICHT selbst; ob beim Host '
-        + 'etwas angekommen ist, weiss das Terminal nicht', 'hostUncertain', 'hostFault', 'documented'),
+        + 'etwas angekommen ist, weiss das Terminal nicht', 'hostUncertain', 'hostFault', 'documented', false, { sendReversal: true }),
     code('100007', 'Processing of TecsXml step failed', 'Schritt beim hobex-Host gescheitert ("Processing of TecsXml step '
         + 'failed") -- das Terminal storniert NICHT selbst; ob beim Host '
-        + 'belastet wurde, weiss das Terminal nicht', 'hostUncertain', 'hostFault', 'documented'),
+        + 'belastet wurde, weiss das Terminal nicht', 'hostUncertain', 'hostFault', 'documented', false, { sendReversal: true }),
     code('100008', 'Invalid TID', 'Terminal-Kennung passt nicht ("Invalid TID") -- die TID der '
         + 'Anfrage ist nicht die eingerichtete; Abweisung vor dem '
         + 'Kartenfluss, nichts belastet (am Geraet gemessen wurde dafuer '
@@ -201,18 +222,18 @@ exports.HPS_CODES = [
         + 'IN_OPERATION; nichts belastet', 'conclusive', 'terminalBlocked', 'documented', true),
     code('100023', 'Invalid message type', 'ungueltige Antwort des hobex-Hosts ("Invalid message type") -- '
         + 'Nachricht und Antwortcode in den UserData ungueltig; ob beim Host '
-        + 'belastet wurde, weiss das Terminal nicht', 'hostUncertain', 'hostFault', 'documented'),
+        + 'belastet wurde, weiss das Terminal nicht', 'hostUncertain', 'hostFault', 'documented', false, { sendReversal: true }),
     code('100024', 'Transaction completion has failed', 'Abschluss des Online-Vorgangs gescheitert ("Transaction completion '
         + 'has failed") -- NACH der Anfrage beim Host; ob belastet bleibt, '
-        + 'weiss das Terminal nicht', 'hostUncertain', 'hostFault', 'documented'),
+        + 'weiss das Terminal nicht', 'hostUncertain', 'hostFault', 'documented', false, { sendReversal: true }),
     code('100025', 'Refund transactions are disabled', 'Gutschriften abgeschaltet ("Refund transactions are disabled") -- '
         + 'in der Geraeteeinstellung; nichts ausgezahlt', 'conclusive', 'refundDisabled', 'documented'),
     code('100026', 'Transaction was declined.', 'Host-Antwort passt nicht zur Karte ("Transaction was declined.") '
         + '-- Chip-Daten fuer eine Karte ohne Chip; das Terminal lehnt ab, ob '
-        + 'der Host zuvor belastet hat, ist offen', 'hostUncertain', 'hostFault', 'documented'),
+        + 'der Host zuvor belastet hat, ist offen', 'hostUncertain', 'hostFault', 'documented', false, { sendReversal: true }),
     code('100027', 'Unsupported UserData in TecsXml Response', 'unbekannte Daten in der Antwort des hobex-Hosts ("Unsupported '
         + 'UserData in TecsXml Response") -- ob beim Host belastet wurde, '
-        + 'weiss das Terminal nicht', 'hostUncertain', 'hostFault', 'documented'),
+        + 'weiss das Terminal nicht', 'hostUncertain', 'hostFault', 'documented', false, { sendReversal: true }),
     code('100028', 'Tip selection process has failed.', 'Trinkgeld nicht gewaehlt ("Tip selection process has failed.") -- '
         + 'nicht innerhalb der Frist; nichts belastet', 'conclusive', 'tipNotSelected', 'documented'),
     code('100029', 'Communication with TecsXml timeout', 'Zeitueberschreitung zum hobex-Host ("Communication with TecsXml '
@@ -224,6 +245,7 @@ exports.HPS_CODES = [
     code('100999', 'Internal Error', 'interner Fehler des Terminals ("Internal Error") -- Sammelcode '
         + 'fuer jeden sonst nicht benannten Fehler, an jeder Stelle des '
         + 'Ablaufs moeglich; ob belastet wurde, ist offen', 'hostUncertain', 'internalError', 'documented'),
+    ...tecs_codes_js_1.TECS_CODES,
 ];
 /**
  * @deprecated Seit 0.10.0 [HPS_CODES] -- die Tabelle fuehrt nicht mehr nur
@@ -345,9 +367,38 @@ exports.TERMINAL_BUSY_HTTP_STATUS = 409;
  */
 exports.NOT_FOUND_HTTP_STATUS = 404;
 const CODE_BY_ID = new Map(exports.HPS_CODES.map((c) => [c.code, c]));
-/** Der Eintrag zu [code] in [HPS_CODES], oder `undefined`, wenn seine Bedeutung nicht feststeht. */
+const PLATZHALTER = 'xx';
+/** Eintraege, die eine ganze Familie abdecken (`81xx`), nach ihrem Praefix. */
+const CODE_BY_PREFIX = new Map(exports.HPS_CODES.filter((c) => c.code.endsWith(PLATZHALTER)).map((c) => [c.code.slice(0, -PLATZHALTER.length), c]));
+/**
+ * Die Schreibweise, unter der [code] in [HPS_CODES] steht: ein rein
+ * numerischer Code ohne fuehrende Nullen (`0055` -> `55`, `0000` -> `0`),
+ * jeder andere unveraendert. Ohne diese Angleichung waere ein `0000` kein
+ * `0` -- und damit eine ABLEHNUNG einer genehmigten Zahlung.
+ * [parseHpsTransactionResponse] gleicht deshalb schon beim Einlesen an.
+ */
+function normalizeHpsCode(code) {
+    const c = code.trim();
+    if (!/^\d+$/.test(c))
+        return c;
+    const ohneNullen = c.replace(/^0+/, '');
+    return ohneNullen === '' ? '0' : ohneNullen;
+}
+/**
+ * Der Eintrag zu [code] in [HPS_CODES], oder `undefined`, wenn seine
+ * Bedeutung nicht feststeht. Findet beide Schreibweisen
+ * ([normalizeHpsCode]) und die Familien mit Platzhalter (`8105` -> `81xx`).
+ */
 function hpsCodeInfo(code) {
-    return code === undefined ? undefined : CODE_BY_ID.get(code);
+    if (code === undefined)
+        return undefined;
+    const c = normalizeHpsCode(code);
+    const genau = CODE_BY_ID.get(c);
+    if (genau)
+        return genau;
+    if (c.length === 4 && /^\d+$/.test(c))
+        return CODE_BY_PREFIX.get(c.slice(0, 2));
+    return undefined;
 }
 /**
  * Der Grund zu [code] -- `'unknown'` fuer einen Code ausserhalb der Tabelle,
@@ -391,7 +442,7 @@ function parseHpsTransactionResponse(raw) {
         // responseCode kommt teils als Zahl, teils als Zeichenkette — siehe
         // Zwilling. Ein leerer String traegt keine Aussage und wird wie ein
         // fehlendes Feld behandelt.
-        responseCode: nonEmpty(stringify(r['responseCode'])),
+        responseCode: normalizedCode(stringify(r['responseCode'])),
         responseText: asString(r['responseText']),
         state: asString(r['state']),
         raw: r,
@@ -421,6 +472,14 @@ function stringify(v) {
 function nonEmpty(v) {
     return v === undefined || v === '' ? undefined : v;
 }
+/**
+ * Der Ergebniscode in der Schreibweise der Tabelle ([normalizeHpsCode]):
+ * `0000` wird `0`. Der Rumpf in `raw` bleibt unveraendert.
+ */
+function normalizedCode(v) {
+    const c = nonEmpty(v?.trim());
+    return c === undefined ? undefined : normalizeHpsCode(c);
+}
 /** `true`, wenn der Vorgang genehmigt ist. */
 function isApproved(res) {
     return res.responseCode === exports.APPROVED_CODE;
@@ -443,7 +502,10 @@ function isNotAbortable(res) {
 function isNoStatement(res) {
     return res.responseCode === exports.NO_STATEMENT_CODE;
 }
-/** `true`, wenn das Terminal einen technischen Fehler meldet (9900). */
+/**
+ * `true`, wenn das Terminal einen technischen Fehler meldet (9900). Seit der
+ * TECS-Liste zugleich [isHostUncertain]: ob belastet wurde, ist offen.
+ */
 function isTechnicalError(res) {
     return res.responseCode === exports.TECHNICAL_ERROR_CODE;
 }
@@ -487,6 +549,14 @@ function isConclusiveAsStatus(res) {
 function isHostUncertain(res) {
     return hpsCodeInfo(res.responseCode)?.effect === 'hostUncertain';
 }
+/**
+ * `true`, wenn zu diesem Code ein Storno nachzuschicken ist
+ * ([HpsCode.sendReversal]) -- der Host hat nicht oder nicht brauchbar
+ * geantwortet, etwa `9908`.
+ */
+function needsReversal(res) {
+    return hpsCodeInfo(res.responseCode)?.sendReversal ?? false;
+}
 /**
  * `true`, wenn ein Ergebniscode VORHANDEN ist, dessen Bedeutung aber nicht
  * feststeht -- er fehlt in [HPS_CODES]. Ein Code, den dieses Modell schlicht

package/dist/esm/payments/hobex-hps/index.d.ts

@@ -23,5 +23,5 @@ export { type HpsPaymentEvent, type HpsPaymentEventKind, type HpsPaymentObserver
 export { type CardPaymentOutcome, type HpsPaymentResult, isHostUncertainResult, mayRetrySafely, } from './outcome.js';
 export { type HpsCancelOptions, type HpsPaymentOptions, type HpsPayments, type HpsPaymentsOptions, type HpsRefundOptions, createHpsPayments, } from './payments.js';
 export { MAX_TRANSACTION_ID_LENGTH, createHpsTransactionIdGenerator, isValidHpsTransactionId, newHpsTransactionId, type HpsTransactionIdGeneratorOptions, } from './transaction-id.js';
-export { ABORTED_CODE, APP_SELECT_FAILED_CODE, APPROVED_CODE, BAD_REQUEST_CODE, CARD_DECLINED_CODE, CARD_INFO_NOT_ENTERED_CODE, CARD_NOT_PRESENT_CODE, CARD_NOT_SUPPORTED_CODE, CARD_READ_FAILED_CODE, CHIP_DATA_MISMATCH_CODE, COMPLETION_FAILED_CODE, DIAGNOSIS_FAILED_CODE, HOST_COMMUNICATION_FAILED_CODE, HOST_STEP_FAILED_CODE, HOST_TIMEOUT_REVERSED_CODE, HPS_CODES, HPS_MEASURED_CODES, HPS_REASON_HINTS, INTERNAL_ERROR_CODE, INVALID_MESSAGE_TYPE_CODE, INVALID_TID_DOCUMENTED_CODE, INVALID_TX_TYPE_CODE, MAX_RETRIES_EXCEEDED_CODE, NOT_FOUND_CODE, PASSWORD_NOT_ENTERED_CODE, REFUND_DISABLED_CODE, REFUND_PASSWORD_INVALID_CODE, SCEP_ENROLLMENT_FAILED_CODE, TERMINAL_BLOCKED_CODE, TERMINAL_BUSY_CODE, TIP_SELECTION_FAILED_CODE, UNSUPPORTED_USER_DATA_CODE, hpsCodeInfo, hpsCodeReason, isHostUncertain, isHostUncertainReason, INVALID_TRANSACTION_CODE, NOT_ABORTABLE_CODE, INVALID_AMOUNT_CODE, AMOUNT_OUT_OF_RANGE_CODE, INVALID_TID_CODE, WRONG_PIN_CODE, NO_STATEMENT_CODE, TECHNICAL_ERROR_CODE, NOT_FOUND_HTTP_STATUS, TERMINAL_BUSY_HTTP_STATUS, TRANSACTION_CANCELED_CODE, isApproved, isCanceled, isConclusive, isConclusiveAsStatus, isInProgress, isNoStatement, isNotAbortable, isTechnicalError, isUnknownCode, parseHpsTransactionResponse, type HpsCode, type HpsCodeEffect, type HpsCodeReason, type HpsCodeSource, type HpsMeasuredCode, type HpsTransactionResponse, } from './transaction-response.js';
+export { ABORTED_CODE, APP_SELECT_FAILED_CODE, APPROVED_CODE, BAD_REQUEST_CODE, CARD_DECLINED_CODE, CARD_INFO_NOT_ENTERED_CODE, CARD_NOT_PRESENT_CODE, CARD_NOT_SUPPORTED_CODE, CARD_READ_FAILED_CODE, CHIP_DATA_MISMATCH_CODE, COMPLETION_FAILED_CODE, DIAGNOSIS_FAILED_CODE, HOST_COMMUNICATION_FAILED_CODE, HOST_STEP_FAILED_CODE, HOST_TIMEOUT_REVERSED_CODE, HPS_CODES, HPS_MEASURED_CODES, HPS_REASON_HINTS, INTERNAL_ERROR_CODE, INVALID_MESSAGE_TYPE_CODE, INVALID_TID_DOCUMENTED_CODE, INVALID_TX_TYPE_CODE, MAX_RETRIES_EXCEEDED_CODE, NOT_FOUND_CODE, PASSWORD_NOT_ENTERED_CODE, REFUND_DISABLED_CODE, REFUND_PASSWORD_INVALID_CODE, SCEP_ENROLLMENT_FAILED_CODE, TERMINAL_BLOCKED_CODE, TERMINAL_BUSY_CODE, TIP_SELECTION_FAILED_CODE, UNSUPPORTED_USER_DATA_CODE, hpsCodeInfo, hpsCodeReason, isHostUncertain, isHostUncertainReason, INVALID_TRANSACTION_CODE, NOT_ABORTABLE_CODE, INVALID_AMOUNT_CODE, AMOUNT_OUT_OF_RANGE_CODE, INVALID_TID_CODE, WRONG_PIN_CODE, NO_STATEMENT_CODE, TECHNICAL_ERROR_CODE, NOT_FOUND_HTTP_STATUS, TERMINAL_BUSY_HTTP_STATUS, TRANSACTION_CANCELED_CODE, isApproved, isCanceled, isConclusive, isConclusiveAsStatus, isInProgress, isNoStatement, isNotAbortable, needsReversal, normalizeHpsCode, isTechnicalError, isUnknownCode, parseHpsTransactionResponse, type HpsCode, type HpsCodeEffect, type HpsCodeReason, type HpsCodeSource, type HpsMeasuredCode, type HpsTransactionResponse, } from './transaction-response.js';
 export { hobexReceiptFromHps } from './receipt.js';

package/dist/esm/payments/hobex-hps/index.js

@@ -22,5 +22,5 @@ export { HpsClarifyTimeoutError, HpsConnectException, HpsConnectTerminalError, H
 export { isHostUncertainResult, mayRetrySafely, } from './outcome.js';
 export { createHpsPayments, } from './payments.js';
 export { MAX_TRANSACTION_ID_LENGTH, createHpsTransactionIdGenerator, isValidHpsTransactionId, newHpsTransactionId, } from './transaction-id.js';
-export { ABORTED_CODE, APP_SELECT_FAILED_CODE, APPROVED_CODE, BAD_REQUEST_CODE, CARD_DECLINED_CODE, CARD_INFO_NOT_ENTERED_CODE, CARD_NOT_PRESENT_CODE, CARD_NOT_SUPPORTED_CODE, CARD_READ_FAILED_CODE, CHIP_DATA_MISMATCH_CODE, COMPLETION_FAILED_CODE, DIAGNOSIS_FAILED_CODE, HOST_COMMUNICATION_FAILED_CODE, HOST_STEP_FAILED_CODE, HOST_TIMEOUT_REVERSED_CODE, HPS_CODES, HPS_MEASURED_CODES, HPS_REASON_HINTS, INTERNAL_ERROR_CODE, INVALID_MESSAGE_TYPE_CODE, INVALID_TID_DOCUMENTED_CODE, INVALID_TX_TYPE_CODE, MAX_RETRIES_EXCEEDED_CODE, NOT_FOUND_CODE, PASSWORD_NOT_ENTERED_CODE, REFUND_DISABLED_CODE, REFUND_PASSWORD_INVALID_CODE, SCEP_ENROLLMENT_FAILED_CODE, TERMINAL_BLOCKED_CODE, TERMINAL_BUSY_CODE, TIP_SELECTION_FAILED_CODE, UNSUPPORTED_USER_DATA_CODE, hpsCodeInfo, hpsCodeReason, isHostUncertain, isHostUncertainReason, INVALID_TRANSACTION_CODE, NOT_ABORTABLE_CODE, INVALID_AMOUNT_CODE, AMOUNT_OUT_OF_RANGE_CODE, INVALID_TID_CODE, WRONG_PIN_CODE, NO_STATEMENT_CODE, TECHNICAL_ERROR_CODE, NOT_FOUND_HTTP_STATUS, TERMINAL_BUSY_HTTP_STATUS, TRANSACTION_CANCELED_CODE, isApproved, isCanceled, isConclusive, isConclusiveAsStatus, isInProgress, isNoStatement, isNotAbortable, isTechnicalError, isUnknownCode, parseHpsTransactionResponse, } from './transaction-response.js';
+export { ABORTED_CODE, APP_SELECT_FAILED_CODE, APPROVED_CODE, BAD_REQUEST_CODE, CARD_DECLINED_CODE, CARD_INFO_NOT_ENTERED_CODE, CARD_NOT_PRESENT_CODE, CARD_NOT_SUPPORTED_CODE, CARD_READ_FAILED_CODE, CHIP_DATA_MISMATCH_CODE, COMPLETION_FAILED_CODE, DIAGNOSIS_FAILED_CODE, HOST_COMMUNICATION_FAILED_CODE, HOST_STEP_FAILED_CODE, HOST_TIMEOUT_REVERSED_CODE, HPS_CODES, HPS_MEASURED_CODES, HPS_REASON_HINTS, INTERNAL_ERROR_CODE, INVALID_MESSAGE_TYPE_CODE, INVALID_TID_DOCUMENTED_CODE, INVALID_TX_TYPE_CODE, MAX_RETRIES_EXCEEDED_CODE, NOT_FOUND_CODE, PASSWORD_NOT_ENTERED_CODE, REFUND_DISABLED_CODE, REFUND_PASSWORD_INVALID_CODE, SCEP_ENROLLMENT_FAILED_CODE, TERMINAL_BLOCKED_CODE, TERMINAL_BUSY_CODE, TIP_SELECTION_FAILED_CODE, UNSUPPORTED_USER_DATA_CODE, hpsCodeInfo, hpsCodeReason, isHostUncertain, isHostUncertainReason, INVALID_TRANSACTION_CODE, NOT_ABORTABLE_CODE, INVALID_AMOUNT_CODE, AMOUNT_OUT_OF_RANGE_CODE, INVALID_TID_CODE, WRONG_PIN_CODE, NO_STATEMENT_CODE, TECHNICAL_ERROR_CODE, NOT_FOUND_HTTP_STATUS, TERMINAL_BUSY_HTTP_STATUS, TRANSACTION_CANCELED_CODE, isApproved, isCanceled, isConclusive, isConclusiveAsStatus, isInProgress, isNoStatement, isNotAbortable, needsReversal, normalizeHpsCode, isTechnicalError, isUnknownCode, parseHpsTransactionResponse, } from './transaction-response.js';
 export { hobexReceiptFromHps } from './receipt.js';

package/dist/esm/payments/hobex-hps/payments.d.ts

@@ -108,6 +108,17 @@ import type { HpsPaymentResult } from './outcome.js';
  *    solcher Code), endet sie sofort als `unresolved` -- das Terminal wird es
  *    auch in 90 Sekunden nicht wissen. Meldet sie dagegen `'0'`, ist die
  *    Zahlung genehmigt, ganz normal.
+ *
+ * ## Storno nach ausbleibender Host-Antwort (16.09.2026)
+ *
+ * Fuer einen Teil dieser Codes -- der Host hat nicht oder nicht brauchbar
+ * geantwortet, etwa `9908` -- gibt hobex vor, ein Storno nachzuschicken
+ * (`sendReversal`). [pay] tut das genau einmal, mit Kennung und Betrag der
+ * Zahlung, bevor die Statusabfrage laeuft: quittiert mit `'0'` -> `declined`
+ * mit `'voidedAfterHostFault'`; sonst weiter wie oben, und ein `9011` in der
+ * Statusabfrage heisst dann ebenfalls `declined`. Am Geraet ungemessen, siehe
+ * Dart-Zwilling. [refund] schickt kein Storno nach (TECS: `9031`), [cancel]
+ * ist selbst eines.
  */
 export interface HpsPaymentsOptions {
     /** Wie lange insgesamt geklaert wird, bevor der Ausgang offen bleibt. Vorgabe 90 s. */

package/dist/esm/payments/hobex-hps/payments.js

@@ -1,8 +1,13 @@
 import { HpsClarifyTimeoutError, HpsConnectException, HpsConnectTerminalError, HpsPreflightError, } from './errors.js';
 import { newHpsTransactionId } from './transaction-id.js';
-import { hpsCodeInfo, hpsCodeReason, isApproved, isCanceled, isConclusive, isConclusiveAsStatus, isHostUncertain, isNoStatement, isNotAbortable, isTechnicalError, isUnknownCode, NOT_ABORTABLE_CODE, NOT_FOUND_CODE, TECHNICAL_ERROR_CODE, TRANSACTION_CANCELED_CODE, } from './transaction-response.js';
+import { hpsCodeInfo, hpsCodeReason, isApproved, isCanceled, isConclusive, isConclusiveAsStatus, isHostUncertain, isNoStatement, isNotAbortable, isTechnicalError, isUnknownCode, needsReversal, NOT_ABORTABLE_CODE, NOT_FOUND_CODE, TECHNICAL_ERROR_CODE, TRANSACTION_CANCELED_CODE, } from './transaction-response.js';
 /** Teiler, mit dem das Abbruchbudget aus [HpsPaymentsOptions.resolveBudgetMs] entsteht. */
 const ABORT_BUDGET_DIVISOR = 6;
+/**
+ * Teiler fuer das Budget des nachgeschickten Stornos: ein Drittel, bei der
+ * Vorgabe 30 s. Ein Storno geht ueber den Host und darf Sekunden brauchen.
+ */
+const REVERSAL_BUDGET_DIVISOR = 3;
 export function createHpsPayments(client, target, options = {}) {
     const resolveBudgetMs = options.resolveBudgetMs ?? 90_000;
     const maxBackoffMs = options.maxBackoffMs ?? 10_000;
@@ -11,6 +16,7 @@ export function createHpsPayments(client, target, options = {}) {
     const now = options.now ?? Date.now;
     const observer = options.observer;
     const abortBudgetMs = Math.trunc(resolveBudgetMs / ABORT_BUDGET_DIVISOR);
+    const reversalBudgetMs = Math.trunc(resolveBudgetMs / REVERSAL_BUDGET_DIVISOR);
     function emit(kind, message, transactionId) {
         if (!observer)
             return;
@@ -67,8 +73,12 @@ export function createHpsPayments(client, target, options = {}) {
         const info = hpsCodeInfo(res.responseCode);
         const was = info.reason === 'internalError'
             ? 'interner Fehler des Terminals'
-            : 'Stoerung zwischen Terminal und hobex-Host, das Terminal storniert nicht selbst';
-        return `Terminal meldet ${was} (${info.code} "${info.title}")`;
+            : info.reason === 'approvedWithCondition'
+                ? 'Genehmigung mit Vorbehalt'
+                : info.reason === 'hostTimeout'
+                    ? 'keine rechtzeitige Antwort des hobex-Hosts, das Terminal storniert nicht selbst'
+                    : 'Stoerung zwischen Terminal und hobex-Host, das Terminal storniert nicht selbst';
+        return `Terminal meldet ${was} (${res.responseCode} "${info.title}")`;
     }
     /**
      * Der Grund eines offenen Ausgangs. [antwort] ist die Antwort auf die
@@ -341,6 +351,37 @@ export function createHpsPayments(client, target, options = {}) {
         emit('resolved', steps[steps.length - 1], id);
         return { outcome: 'declined', transactionId: id, response: res, reason: 'aborted', steps: [...steps] };
     }
+    /**
+     * Schickt zu einer Zahlung, deren Host-Antwort ausblieb ([anlass] traegt
+     * `sendReversal`), GENAU EINMAL ein Storno nach. Ergebnis nur, wenn das
+     * Terminal es mit `'0'` quittiert; sonst `null`. Ohne [amountCents]
+     * (Gutschrift) wird nichts gesendet.
+     */
+    async function sendReversal(id, steps, elapsedMs, amountCents, anlass) {
+        if (amountCents === undefined) {
+            steps.push('Kein Storno nachgeschickt -- die Aufhebung einer Gutschrift laesst TECS nicht zu');
+            return null;
+        }
+        emit('resolving', `Storno wird nachgeschickt (${anlass.responseCode})`, id);
+        let res;
+        try {
+            res = await withinBudget(elapsedMs, () => client.cancel({ ...target, transactionId: id, amountCents }), reversalBudgetMs);
+        }
+        catch (e) {
+            steps.push(`Storno nachgeschickt, aber nicht bestaetigt (${describe(e)}) -- ob es wirkte, ist offen, Ausgang wird abgefragt`);
+            noteUnexpected(e, id);
+            return null;
+        }
+        if (!isApproved(res)) {
+            const titel = hpsCodeInfo(res.responseCode)?.title;
+            steps.push(`Storno nachgeschickt, nicht bestaetigt (${res.responseCode ?? 'ohne Ergebniscode'}`
+                + `${titel === undefined ? '' : ` "${titel}"`}) -- Ausgang wird abgefragt`);
+            return null;
+        }
+        steps.push('Storno nachgeschickt und bestaetigt -- die Zahlung ist aufgehoben, es ist nichts belastet');
+        emit('resolved', steps[steps.length - 1], id);
+        return { outcome: 'declined', transactionId: id, response: res, reason: 'voidedAfterHostFault', steps: [...steps] };
+    }
     /**
      * Klaert einen offenen Ausgang: erst abbrechen, dann abfragen -- bis das
      * Terminal etwas sagt oder das Budget aufgebraucht ist.
@@ -353,7 +394,7 @@ export function createHpsPayments(client, target, options = {}) {
      * ([isHostUncertain]), bekommt `9027` diesen Aussagewert gerade NICHT --
      * siehe Klassendoku, "Stoerung beim Host".
      */
-    async function resolve(id, steps, antwort) {
+    async function resolve(id, steps, antwort, stornoCents) {
         emit('resolving', 'Ausgang offen, Klaerung laeuft', id);
         const start = now();
         const elapsedMs = () => now() - start;
@@ -362,6 +403,9 @@ export function createHpsPayments(client, target, options = {}) {
         // Statusabfrage sie nennt und danach 9027 kommt.
         let stoerungsAntwort = antwort && isHostUncertain(antwort) ? antwort : undefined;
         let letzteAntwort = antwort;
+        // Das Storno wird hoechstens einmal erwogen; gesendet ist es nur mit Betrag.
+        let stornoErwogen = false;
+        let stornoGesendet = false;
         if (stoerungsAntwort === undefined) {
             const aborted = await tryAbort(id, steps, elapsedMs);
             if (aborted)
@@ -372,6 +416,13 @@ export function createHpsPayments(client, target, options = {}) {
             // Host. Ein quittierter Abbruch bewiese nur, dass am Terminal nichts mehr
             // laeuft, nicht, dass der Host nichts belastet hat.
             steps.push('Kein Abbruchversuch -- das Terminal hat den Vorgang mit einer Stoerung beim hobex-Host beendet');
+            if (needsReversal(stoerungsAntwort)) {
+                stornoErwogen = true;
+                stornoGesendet = stornoCents !== undefined;
+                const storniert = await sendReversal(id, steps, elapsedMs, stornoCents, stoerungsAntwort);
+                if (storniert)
+                    return storniert;
+            }
         }
         let wait = 0;
         let transportFailures = 0;
@@ -406,6 +457,24 @@ export function createHpsPayments(client, target, options = {}) {
             if (isHostUncertain(status))
                 stoerungsAntwort ??= status;
             const hostUngewiss = stoerungsAntwort !== undefined;
+            if (stornoGesendet && isCanceled(status)) {
+                steps.push(`Status: Zahlung aufgehoben (${TRANSACTION_CANCELED_CODE}) -- das nachgeschickte Storno hat gegriffen, `
+                    + 'es ist nichts belastet');
+                emit('resolved', steps[steps.length - 1], id);
+                return { outcome: 'declined', transactionId: id, response: status, reason: 'voidedAfterHostFault', steps: [...steps] };
+            }
+            if (!stornoErwogen && needsReversal(status)) {
+                // Die Zahlung selbst kam ohne Antwort zurueck, erst die Statusabfrage
+                // nennt die ausgebliebene Host-Antwort -- dasselbe Storno wie oben.
+                steps.push(statusOhneErgebnis(status));
+                stornoErwogen = true;
+                stornoGesendet = stornoCents !== undefined;
+                const storniert = await sendReversal(id, steps, elapsedMs, stornoCents, status);
+                if (storniert)
+                    return storniert;
+                wait = nextWait(wait);
+                continue;
+            }
             // Auf die Statusabfrage entscheidet nur ein Code, der den gesuchten
             // Vorgang beschreibt -- nicht einer, der diese Abfrage abweist
             // ([isConclusiveAsStatus]). Nach einer Stoerung beim Host entscheidet nur
@@ -607,7 +676,7 @@ export function createHpsPayments(client, target, options = {}) {
                 return settled;
             steps.push(offeneAntwort(res));
         }
-        return resolve(id, steps, res);
+        return resolve(id, steps, res, paymentOptions.amountCents);
     }
     /**
      * Gutschrift mit geklaertem Ausgang -- EXAKT derselbe Klaerweg wie [pay]

package/dist/esm/payments/hobex-hps/tecs-codes.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Die Antwortcodeliste von TECS, erhalten ueber hobex am 16.09.2026.
+ *
+ * **Zwilling:** `kasseneck_api/lib/src/hobex_hps/tecs_codes.dart` -- dort
+ * steht die Einordnung ausfuehrlich. Kurz: eine Antwort des Hosts ohne
+ * Genehmigung lehnt ab; eine Genehmigung, die nicht `0` ist, bleibt offen;
+ * keine oder keine brauchbare Host-Antwort bleibt offen und bekommt ein
+ * Storno; Codes anderer TECS-Produkte sagen nichts ueber die Zahlung.
+ *
+ * TECS fuehrt die Host-Antworten vierstellig (`0055`), das Terminal sendet
+ * sie ohne Nullen (`55`). Die Tabelle fuehrt die Form des Terminals.
+ * Gemessene Codes (`0`, `9002`, `9003`, `9011`, `9027`, `9900`, `55`)
+ * stehen in `transaction-response.ts`, hier nur die uebrigen.
+ */
+import type { HpsCode } from './transaction-response.js';
+export declare const TECS_CODES: readonly HpsCode[];