@kreiseck/kasseneck-api 1.35.0 → 1.35.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -4,6 +4,16 @@ Was vor 0.7.0 geschah, steht in der Commit-Historie (`git log`); ab hier wird
4
4
  es hier geführt. Ein Eintrag nennt die Änderung **und ihren Grund** —
5
5
  nur der Grund überlebt den nächsten Umbau.
6
6
 
7
+ ## 1.35.1 - unveröffentlicht
8
+
9
+ Fixes in the hobex HPS card payment through Kasseneck Connect (`./payments`). The first two were measured at the test terminal 3600335 (HPS 1.14.4, firmware 7.3.6, `tecstest.hobex.at`) on 10.11.2026; the reversal fix follows from the same lesson.
10
+
11
+ - **An accepted abort no longer means "nothing charged".** Until now the clarification of a payment or refund without an answer (transport error, timeout, an answer without a decision) read `responseCode '0'` on `POST /api/transaction/abort` as proof that the transaction was still abortable and returned `declined` with reason `aborted`, without asking the status. Measured: an abort sent four seconds into a contactless payment of 0.01 EUR was answered with `'0'` "Authorized" after 0.18 s, and the running payment still ended **approved**; the status query afterwards said approved as well. Read as `declined`, the till would have said "nothing charged, try again" for a charged card. Now the answer to the abort decides nothing and only goes into `steps` (the entry starts with "Abbruch angenommen (0)" and says that this does not tell whether the card was charged); the status query always follows: `'0'` -> `approved` with the status answer as `response`, a conclusive code (e.g. `9011` canceled) -> `declined`, `9027` -> keep asking, and only after an answer with a code to the payment the two-`9027` rule makes it `declined`. A payment without any answer, an accepted abort and a status that stays `9027` now ends as `unresolved` instead of `declined`: while a payment runs the status also answers `9027`, and how long an approval can still arrive after an accepted abort is not measured. When the till aborts a running payment itself (its own `abort` call while `pay()` still waits), the answer to the payment decides, as before; `pay()` never reads that abort's answer. Reason `aborted` now only comes from a terminal code (`100002`).
12
+ - **A confirmed reversal after a host fault no longer means "nothing charged" either, and it now reverses the tip too.** After a host code that asks for a reversal (`sendReversal`, e.g. `9908`), `pay()` used to return `declined` with reason `voidedAfterHostFault` as soon as the void answered `'0'`, without asking the status. Like the abort, that answer alone proves nothing. Now the status query always follows: `9011` (canceled) -> `declined`, with reason `voidedAfterHostFault` if the void may have worked, `canceled` if it provably did not (then something else canceled the payment, and `steps` says so instead of "the reversal took effect"). Unless the void was provably not executed, a `'0'` in the status is no statement either (the void may still be on its way or may not have taken effect); it counts as "nothing new" like `9027`, and two of those end as `unresolved`. "Provably not executed" is an explicit positive list: not sent (`HpsPreflightError`, Connect refused it before the terminal; the trail now says so instead of "whether it worked is open"), not accepted (HTTP 409), or refused with a conclusive code that rejects the request itself (`rejectsRequest`, e.g. `9002`, the only one measured on a void, 27.08.2026), denies the cancellation (`cancelDenied`: `9023`, `9222`) or refuses the amount (`amountInvalid`). Everything else may have worked, explicitly codes that themselves mean "reversed" or "canceled" (`8009`, `100029`, `3053`-`3063`, `9032`, `9011`), abort codes (`100002`, `17`, `8004`), host declines and unknown codes. The reversal amount is now what the terminal charged, `amountCents + tipCents` (as the till's own refund does), not `amountCents` alone. Not measured at the device: the reversal after a host fault and a reversal amount with tip.
13
+ - **TID without leading zero.** The TID printed on the receipt and shown on the device has eight digits with a leading zero (`03600335`); the HPS only accepts it without (`3600335`) and answers diagnosis and payment with `100108 "Invalid TID"` otherwise (`003600335`, `0360033` and `36003350` as well). The Connect client now writes the TID once, for every call (payment, status, abort, refund, cancel, diagnosis), without surrounding white space and leading zeros (`normalizeHpsTid` in `connect-client.ts`, not exported from `./payments`). Only a TID of digits with at least one digit other than `0` is rewritten; anything else, the probe TID `0` and a TID of zeros only go out unchanged (Connect refuses a TID that is not digits only with `bad_request`, the HPS an unknown one with `100108`; in both cases nothing is charged). White space means ASCII only (space, tab, LF, CR, VT, FF), the same fixed list as in Dart, because JavaScript and Dart trim Unicode white space differently (U+0085). A TID that is not a string (a caller without type checks passing a number) also goes out unchanged, so Connect refuses it before the terminal (`HpsPreflightError`) instead of a throw inside the payment turning into an open outcome. The caller's target object is not changed. The doc comment that claimed leading zeros were tolerated is corrected.
14
+ - **Contract:** new file `fixtures/hobex-hps-cases.json` with the TID cases, receipt cases (`hobexReceiptFromHps` + `hobexReceiptToCardPaymentData` on the full measured payment answer and on a status answer in the v2 form from the shortened 10.11. notes: `aid`, `cvm` as number, `currency: null`; whether `transactionId` is missing there is assumed, not measured, so it is checked with and without) and the clarification cases built from the measured answers, among them the reversal cases (and `reversalAnswers`: every listed answer to the void, once with an approval and once with `9011` in the status), a later approval after two `9027`, a till abort answered with `100002` and an abort answered with HTTP 404; the Dart twin computes the same cases. Card data in the contract and in the tests is a test card (`541333******0021`, expiry `2912`); the real card data of the test terminal (number, expiry, cryptogram, VU) is removed from `fixtures/` and `test/`, in `fixtures/receipts/card-hobex-hps.json` the expiry only (the printed bon and all goldens are unchanged, only its input hash in `manifest.json` moves); real approval and receipt numbers of the test terminal in the tests and doc comments are replaced by invented ones or dropped.
15
+ - `fixtures/surface.json`, `pos-texts.json`, `invoice-texts.json`, `hobex-hps-codes.json` and `invoice-api.schema.json` regenerated for the version.
16
+
7
17
  ## 1.35.0 - unveröffentlicht
8
18
 
9
19
  Printer catalog for setting up a receipt printer through Kasseneck Connect with one click. Additive; every existing call, receipt and golden behaves as before.
@@ -23,9 +23,44 @@ export interface HpsConnectTarget {
23
23
  host: string;
24
24
  /** Vorgabe: `8080` (hobex-HPS-Standardport), siehe Connect. */
25
25
  port?: number;
26
- /** Terminal-ID, wie am Geraet angezeigt (fuehrende Nullen werden toleriert). */
26
+ /**
27
+ * Terminal-ID, gern so, wie sie am Geraet und auf dem Beleg steht (achtstellig
28
+ * mit fuehrender Null, `03600335`). Das HPS kennt sie nur OHNE fuehrende Null
29
+ * und weist jede andere Schreibweise mit `100108 "Invalid TID"` ab; dieser
30
+ * Client schreibt sie deshalb vor jedem Aufruf um, siehe [normalizeHpsTid].
31
+ */
27
32
  tid: string;
28
33
  }
34
+ /**
35
+ * Die TID in der Form, die das hobex-HPS annimmt: Leerraum am Rand
36
+ * ([RAND_LEERRAUM]) und fuehrende Nullen fallen weg.
37
+ *
38
+ * Am 10.11.2026 gemessen (TID 3600335, HPS 1.14.4, Firmware 7.3.6): Diagnose
39
+ * und Zahlung mit `03600335` antworten sofort `100108 "Invalid TID"` (nichts
40
+ * belastet), mit `3600335` normal; `003600335`, `0360033` und `36003350` sind
41
+ * ebenfalls `Invalid TID`. Auf Beleg und Geraet steht die TID achtstellig mit
42
+ * fuehrender Null -- so wird sie auch eingetragen.
43
+ *
44
+ * Umgeschrieben wird NUR eine rein ziffrige TID mit mindestens einer Ziffer
45
+ * ungleich `0`. Alles andere geht UNVERAENDERT hinaus, auch die `0` der
46
+ * Erkennungsprobe von Connect und eine TID aus lauter Nullen: still etwas
47
+ * anderes daraus zu machen, hiesse ein anderes Terminal anzusprechen als das
48
+ * eingetragene. Bewusst kein Wurf: Connect weist eine nicht rein ziffrige TID
49
+ * selbst ab (`bad_request`, vor jedem Terminal-Kontakt, hier
50
+ * [HpsPreflightError]), und das HPS antwortet auf eine unbekannte mit
51
+ * `100108` -- in beiden Faellen geht kein Geld, und der Aufrufer bekommt den
52
+ * Grund auf dem Weg, den er fuer jede andere Abweisung auch auswertet.
53
+ *
54
+ * Kein Text (ein Aufrufer ohne Typpruefung uebergibt etwa eine Zahl) geht
55
+ * ebenso unveraendert hinaus: Connect weist ihn dann mit "Es fehlt die
56
+ * Terminal-ID" ab ([HpsPreflightError]), statt dass hier ein Wurf aus dem
57
+ * Zahlweg einen offenen Ausgang machte.
58
+ *
59
+ * Die einzige Stelle, an der die TID umgeschrieben wird: jeder Aufruf geht
60
+ * ueber `target`. Zwilling: `HpsClient` im Dart-Paket (`_normalizeTid`), Faelle
61
+ * in `fixtures/hobex-hps-cases.json`.
62
+ */
63
+ export declare function normalizeHpsTid(tid: string): string;
29
64
  export interface HpsConnectPaymentOptions extends HpsConnectTarget {
30
65
  /** Kennung dieser Zahlung — MUSS vor diesem Aufruf feststehen, siehe `transaction-id.ts`. */
31
66
  transactionId: string;
@@ -93,6 +128,13 @@ export interface HpsConnectClientOptions {
93
128
  export interface HpsConnectClient {
94
129
  payment(options: HpsConnectPaymentOptions): Promise<HpsTransactionResponse>;
95
130
  status(options: HpsConnectTransactionOptions): Promise<HpsTransactionResponse>;
131
+ /**
132
+ * Abbruch eines laufenden Vorgangs. `responseCode '0'` heisst nur, dass das
133
+ * Terminal die Anfrage angenommen hat -- NICHT, dass der Vorgang abgebrochen
134
+ * ist: am 10.11.2026 endete eine Zahlung nach so einer Quittung genehmigt.
135
+ * Den Ausgang sagt die Antwort auf die Zahlung oder die Statusabfrage, siehe
136
+ * `payments.ts`.
137
+ */
96
138
  abort(options: HpsConnectTransactionOptions): Promise<HpsTransactionResponse>;
97
139
  /** Gutschrift — ein Kartenfluss wie [payment], deshalb dieselbe lange Frist. */
98
140
  refund(options: HpsConnectRefundOptions): Promise<HpsTransactionResponse>;
@@ -1,9 +1,59 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.normalizeHpsTid = normalizeHpsTid;
3
4
  exports.createHpsConnectClient = createHpsConnectClient;
4
5
  const errors_js_1 = require("./errors.js");
5
6
  const transaction_id_js_1 = require("./transaction-id.js");
6
7
  const transaction_response_js_1 = require("./transaction-response.js");
8
+ /** Nur eine rein ziffrige TID wird umgeschrieben. */
9
+ const NUR_ZIFFERN = /^[0-9]+$/;
10
+ const FUEHRENDE_NULLEN = /^0+/;
11
+ /**
12
+ * Leerraum am Rand, der wegfaellt: nur ASCII (Leerzeichen, Tab, Zeilenvorschub,
13
+ * Wagenruecklauf, vertikaler Tab, Seitenvorschub). Bewusst eine feste Liste
14
+ * statt `trim()`: JavaScript und Dart zaehlen Unicode-Leerraum verschieden
15
+ * (U+0085 trimmt Dart, JavaScript nicht), und die Zwillinge sollen dieselbe
16
+ * TID hinausschicken. Jedes andere Zeichen am Rand laesst die TID unveraendert.
17
+ */
18
+ const RAND_LEERRAUM = /^[ \t\n\r\x0B\x0C]+|[ \t\n\r\x0B\x0C]+$/g;
19
+ /**
20
+ * Die TID in der Form, die das hobex-HPS annimmt: Leerraum am Rand
21
+ * ([RAND_LEERRAUM]) und fuehrende Nullen fallen weg.
22
+ *
23
+ * Am 10.11.2026 gemessen (TID 3600335, HPS 1.14.4, Firmware 7.3.6): Diagnose
24
+ * und Zahlung mit `03600335` antworten sofort `100108 "Invalid TID"` (nichts
25
+ * belastet), mit `3600335` normal; `003600335`, `0360033` und `36003350` sind
26
+ * ebenfalls `Invalid TID`. Auf Beleg und Geraet steht die TID achtstellig mit
27
+ * fuehrender Null -- so wird sie auch eingetragen.
28
+ *
29
+ * Umgeschrieben wird NUR eine rein ziffrige TID mit mindestens einer Ziffer
30
+ * ungleich `0`. Alles andere geht UNVERAENDERT hinaus, auch die `0` der
31
+ * Erkennungsprobe von Connect und eine TID aus lauter Nullen: still etwas
32
+ * anderes daraus zu machen, hiesse ein anderes Terminal anzusprechen als das
33
+ * eingetragene. Bewusst kein Wurf: Connect weist eine nicht rein ziffrige TID
34
+ * selbst ab (`bad_request`, vor jedem Terminal-Kontakt, hier
35
+ * [HpsPreflightError]), und das HPS antwortet auf eine unbekannte mit
36
+ * `100108` -- in beiden Faellen geht kein Geld, und der Aufrufer bekommt den
37
+ * Grund auf dem Weg, den er fuer jede andere Abweisung auch auswertet.
38
+ *
39
+ * Kein Text (ein Aufrufer ohne Typpruefung uebergibt etwa eine Zahl) geht
40
+ * ebenso unveraendert hinaus: Connect weist ihn dann mit "Es fehlt die
41
+ * Terminal-ID" ab ([HpsPreflightError]), statt dass hier ein Wurf aus dem
42
+ * Zahlweg einen offenen Ausgang machte.
43
+ *
44
+ * Die einzige Stelle, an der die TID umgeschrieben wird: jeder Aufruf geht
45
+ * ueber `target`. Zwilling: `HpsClient` im Dart-Paket (`_normalizeTid`), Faelle
46
+ * in `fixtures/hobex-hps-cases.json`.
47
+ */
48
+ function normalizeHpsTid(tid) {
49
+ if (typeof tid !== 'string')
50
+ return tid;
51
+ const ohneRand = tid.replace(RAND_LEERRAUM, '');
52
+ if (!NUR_ZIFFERN.test(ohneRand))
53
+ return tid;
54
+ const ohneNullen = ohneRand.replace(FUEHRENDE_NULLEN, '');
55
+ return ohneNullen === '' ? tid : ohneNullen;
56
+ }
7
57
  const DEFAULT_BASE_URL = 'http://127.0.0.1:27182';
8
58
  const DEFAULT_SHORT_TIMEOUT_MS = 30_000;
9
59
  const DEFAULT_PAYMENT_TIMEOUT_MS = 4 * 60_000 + 30_000;
@@ -86,7 +136,7 @@ function createHpsConnectClient(options) {
86
136
  return value;
87
137
  }
88
138
  function target(t) {
89
- return { host: t.host, port: t.port, tid: t.tid };
139
+ return { host: t.host, port: t.port, tid: normalizeHpsTid(t.tid) };
90
140
  }
91
141
  return {
92
142
  async payment(o) {
@@ -40,9 +40,10 @@ export interface HpsPaymentResult {
40
40
  * fuer den Bediener in `HPS_REASON_HINTS`.
41
41
  *
42
42
  * Gesetzt an der Stelle, die den Ausgang entschieden hat, nicht aus
43
- * [response] abgeleitet: ein bestaetigter Abbruch antwortet `'0'` und ist
44
- * trotzdem `'aborted'`, und wenn die Zwei-9027-Regel eine Zahlung als
45
- * abgelehnt klaert, zaehlt der Code der ZAHLUNG, nicht das `9027` danach.
43
+ * [response] abgeleitet: ein quittiertes Storno nach einer Stoerung beim
44
+ * Host antwortet `'0'` und ist trotzdem `'voidedAfterHostFault'`, und wenn
45
+ * die Zwei-9027-Regel eine Zahlung als abgelehnt klaert, zaehlt der Code der
46
+ * ZAHLUNG, nicht das `9027` danach.
46
47
  * Fehlt, wenn kein Code etwas erklaert (die Leitung riss ab, bevor das
47
48
  * Terminal etwas sagte) und bei einer Aufhebung, die nicht gegriffen hat.
48
49
  */
@@ -15,49 +15,80 @@ import type { HpsPaymentResult } from './outcome.js';
15
15
  *
16
16
  * Regel, von der nicht abgewichen wird: `outcome: 'declined'` entsteht
17
17
  * ausschliesslich aus einer POSITIVEN Aussage — einem GEMESSENEN Ergebniscode
18
- * des Terminals ungleich `'0'` ([isConclusive]), einem nachweislich
19
- * gelungenen Abbruch, oder dem gemessenen "Terminal beschaeftigt"-Fall
20
- * (HTTP 409 auf die ERZEUGENDE Anfrage, siehe `errors.ts`,
21
- * `HpsConnectTerminalError.isTerminalBusy`). Ein Transportfehler, ein
22
- * Zeitablauf oder eine Wissensluecke fuehren NIE dorthin: keines davon ist
18
+ * des Terminals ungleich `'0'` ([isConclusive]) auf die Zahlung oder in der
19
+ * Statusabfrage, der Zwei-9027-Regel nach einer Antwort MIT Code
20
+ * ([ausGeschlossenerAntwort]), einem `9011` (aufgehoben) in der Statusabfrage
21
+ * nach einem nachgeschickten Storno, oder dem gemessenen "Terminal
22
+ * beschaeftigt"-Fall (HTTP 409 auf die ERZEUGENDE Anfrage, siehe
23
+ * `errors.ts`, `HpsConnectTerminalError.isTerminalBusy`). Ein
24
+ * Transportfehler, ein Zeitablauf, eine Wissensluecke, ein quittierter
25
+ * Abbruch und ein quittiertes Storno fuehren NIE dorthin: keines davon ist
23
26
  * eine Aussage darueber, dass nichts belastet wurde. Genau diese
24
27
  * Verwechslung hat am 24.08.2026 eine echte Belastung als unbelastet
25
28
  * ausgewiesen und den Kunden ein zweites Mal belastet.
26
29
  *
27
- * ## Der Klaerweg, wie er am 26./27.08.2026 am hobex-HPS gemessen wurde
30
+ * ## Der Klaerweg
28
31
  *
29
- * Bleibt die Antwort auf eine Zahlung aus:
32
+ * Bleibt die Antwort auf eine Zahlung aus, oder sagt sie nichts:
30
33
  *
31
- * 1. [HpsConnectClient.abort] einmalig versuchen.
32
- * 2. `responseCode === '0'` -> der Vorgang war noch abbrechbar, also nicht
33
- * abgeschlossen -> `declined`, beweisbar.
34
- * 3. Jeder andere Code (gemessen `100010`) -> der Vorgang ist ueber den
35
- * abbrechbaren Punkt hinaus -> JETZT die Statusabfrage pollen, sie liefert
36
- * nun eine echte Aussage.
37
- * 4. Abbruch scheitert am Transport -> pollen wie in 3.
38
- * 5. Beim Pollen ist `9027` KEIN Ergebnis, sondern ein Grund weiterzumachen.
39
- * Budget erschoepft -> `unresolved`.
34
+ * 1. [HpsConnectClient.abort] einmalig versuchen. Die Absicht: ein
35
+ * Kartenfluss, der noch auf die Karte wartet, soll enden, damit nach der
36
+ * Klaerung keine spaet aufgelegte Karte mehr belastet wird. Eine Garantie
37
+ * ist das nicht -- ob der Abbruch greift, sagt seine Quittung nicht.
38
+ * 2. Die Antwort auf den Abbruch entscheidet NICHTS, auch `'0'` nicht (siehe
39
+ * "Ein quittierter Abbruch ist keine Aussage"). Sie steht nur im Nachweis.
40
+ * 3. Dann die Statusabfrage pollen: `'0'` -> `approved`, mit der Antwort des
41
+ * Status als Beleg; ein schluessiger Code (etwa `9011` aufgehoben) ->
42
+ * `declined`; `9027` ist KEIN Ergebnis, sondern ein Grund weiterzumachen
43
+ * -- ausser nach einer Antwort MIT Code auf die Zahlung, siehe
44
+ * [ausGeschlossenerAntwort].
45
+ * 4. Budget erschoepft -> `unresolved`.
40
46
  *
41
- * Der Abbruch VOR dem Pollen ist wesentlich: die Statusabfrage meldet
42
- * "laeuft noch" nie (sie antwortet auf jeden nicht genehmigten Vorgang mit
43
- * `9027`). Der Abbruchversuch ist auf einen Bruchteil des Klaerbudgets
44
- * gedeckelt ([ABORT_BUDGET_DIVISOR]), sonst friesst ein haengender Abbruch
45
- * die ganze Klaerung.
47
+ * Der Abbruchversuch ist auf einen Bruchteil des Klaerbudgets gedeckelt
48
+ * ([ABORT_BUDGET_DIVISOR]), sonst friesst ein haengender Abbruch die ganze
49
+ * Klaerung.
46
50
  *
47
51
  * Die Kennung ist in JEDEM Ergebnis gesetzt, auch bei `'unresolved'`.
48
52
  *
53
+ * ## Ein quittierter Abbruch ist keine Aussage (10.11.2026)
54
+ *
55
+ * Bis 1.35.0 hiess `'0'` auf den Abbruch "der Vorgang war noch abbrechbar,
56
+ * es ist nichts belastet" -- geschlossen aus einer Messung vom 26.08.2026, bei
57
+ * der der Abbruch WAEHREND des Wartens auf die Karte kam und die Zahlung
58
+ * danach mit `100002` "Aborted" endete. Am 10.11.2026 widerlegt (TID 3600335,
59
+ * HPS 1.14.4, Firmware 7.3.6, Testsystem): Abbruch vier Sekunden nach dem
60
+ * Start einer Zahlung ueber 0,01 EUR, nach 0,18 s quittiert mit `'0'`
61
+ * "Authorized" -- und die laufende Zahlung endete trotzdem GENEHMIGT
62
+ * (kontaktlos), die Statusabfrage danach ebenso. `'0'`
63
+ * heisst also nur, dass das Terminal die Abbruch-Anfrage angenommen hat,
64
+ * nicht, dass die Zahlung abgebrochen ist. Als `declined` gelesen, haette die
65
+ * Kasse "nichts belastet, noch einmal versuchen" gemeldet: der Weg zur
66
+ * Doppelbelastung vom 24.08.2026.
67
+ *
68
+ * Auch ein `9027` kurz nach einem angenommenen Abbruch ist keine Aussage:
69
+ * solange eine Zahlung laeuft, antwortet die Statusabfrage `9027` (gemessen
70
+ * 26.08.2026), und dass sie nach einem angenommenen Abbruch weiterlaufen kann,
71
+ * zeigt die Messung oben. Wie lange danach noch eine Genehmigung kommen kann,
72
+ * ist ungemessen. Ohne Antwort mit Code auf die Zahlung endet ein Abbruch mit
73
+ * anhaltendem `9027` deshalb bei `unresolved`, nicht bei `declined`.
74
+ *
75
+ * Bricht die KASSE eine laufende Zahlung ab (eigener Aufruf von
76
+ * [HpsConnectClient.abort], waehrend [pay] noch auf die Antwort wartet),
77
+ * entscheidet die Antwort auf die Zahlung selbst -- `approved`, wenn sie
78
+ * genehmigt meldet, `declined` mit `100002`. [pay] liest die Quittung dieses
79
+ * fremden Abbruchs nicht.
80
+ *
49
81
  * ## [refund] bekommt EXAKT denselben Klaerweg wie [pay]
50
82
  *
51
- * Abbruch eingeschlossen -- und das ist GEMESSEN, nicht analog geschlossen.
52
- * Am 26.08.2026 nachgemessen: `abort` auf eine LAUFENDE Gutschrift antwortet
53
- * ebenfalls mit `responseCode '0'`, und die Gutschrift endet daraufhin mit
54
- * `100002` "Aborted". Der Abbruch ist dort also derselbe Diskriminator wie bei
55
- * einer Zahlung. Die Kennung ist bei [refund] die des NEUEN Vorgangs (der
56
- * Gutschrift selbst), eine Statusabfrage darauf liefert also genau deren
57
- * Ausgang -- deshalb reicht dieselbe [resolve]-Funktion unveraendert. Ohne den
58
- * Abbruch haette die Klaerung einer Gutschrift gar keinen Diskriminator mehr
59
- * und endete fast immer bei `unresolved`, weil die Statusabfrage auch hier
60
- * `9027` antwortet.
83
+ * Abbruch eingeschlossen. Die Kennung ist bei [refund] die des NEUEN Vorgangs
84
+ * (der Gutschrift selbst), eine Statusabfrage darauf liefert also genau deren
85
+ * Ausgang -- deshalb reicht dieselbe [resolve]-Funktion unveraendert. Am
86
+ * 26.08.2026 gemessen: `abort` auf eine LAUFENDE Gutschrift antwortet
87
+ * ebenfalls mit `responseCode '0'`, und die Gutschrift endete daraufhin mit
88
+ * `100002` "Aborted". Wie bei der Zahlung beweist die Quittung allein nichts:
89
+ * eine Gutschrift, die nach dem angenommenen Abbruch doch durchgeht, als
90
+ * `declined` zu melden, laedt zu einer zweiten Gutschrift ein. Bleibt die
91
+ * Statusabfrage danach bei `9027`, endet die Klaerung bei `unresolved`.
61
92
  *
62
93
  * ## [cancel] ist die Ausnahme, in beiden Richtungen
63
94
  *
@@ -113,10 +144,29 @@ import type { HpsPaymentResult } from './outcome.js';
113
144
  *
114
145
  * Fuer einen Teil dieser Codes -- der Host hat nicht oder nicht brauchbar
115
146
  * geantwortet, etwa `9908` -- gibt hobex vor, ein Storno nachzuschicken
116
- * (`sendReversal`). [pay] tut das genau einmal, mit Kennung und Betrag der
117
- * Zahlung, bevor die Statusabfrage laeuft: quittiert mit `'0'` -> `declined`
118
- * mit `'voidedAfterHostFault'`; sonst weiter wie oben, und ein `9011` in der
119
- * Statusabfrage heisst dann ebenfalls `declined`. Am Geraet ungemessen, siehe
147
+ * (`sendReversal`). [pay] tut das genau einmal, mit der Kennung der Zahlung
148
+ * und dem Betrag, den das Terminal belastet: Betrag UND Trinkgeld (wie die
149
+ * Rueckbuchung der Web-Kasse). Danach laeuft immer die Statusabfrage:
150
+ *
151
+ * - `9011` (aufgehoben) -> `declined`, die einzige Stelle, an der nach einem
152
+ * Storno ein Ausgang feststeht: mit `'voidedAfterHostFault'`, wenn das
153
+ * Storno gewirkt haben kann, sonst mit `'canceled'` -- dann hat etwas
154
+ * anderes die Zahlung aufgehoben.
155
+ * - Ist das Storno nicht sicher abgewiesen ([StornoAusgang]: quittiert mit
156
+ * `'0'`, abgerissen, ohne Code, mit einem unbekannten oder einem
157
+ * Storniert-Code wie `8009`), ist auch `'0'` in der Statusabfrage keine
158
+ * Aussage: das Storno kann noch unterwegs sein, oder es hat nicht
159
+ * gegriffen. Sie zaehlt dann wie `9027` als "nichts Neues", und nach zwei
160
+ * solchen Antworten endet die Klaerung als `unresolved`.
161
+ * - Nur wenn das Storno nach einer ausdruecklichen Positivliste NICHT
162
+ * ausgefuehrt wurde (nicht gesendet, nicht angenommen, abgewiesen -- siehe
163
+ * [stornoAbgewiesen]), ist `'0'` in der Statusabfrage `approved`. Gemessen
164
+ * ist davon nur `9002` auf eine unbekannte Kennung (27.08.2026); die
165
+ * uebrigen Eintraege stuetzen sich auf die Codeliste von hobex und TECS.
166
+ *
167
+ * Die Quittung `'0'` auf das Storno allein beweist nichts -- dieselbe Lehre
168
+ * wie beim Abbruch (10.11.2026). Am Geraet ungemessen sind das Storno nach
169
+ * einer Host-Stoerung und der Stornobetrag mit Trinkgeld, siehe
120
170
  * Dart-Zwilling. [refund] schickt kein Storno nach (TECS: `9031`), [cancel]
121
171
  * ist selbst eines.
122
172
  */
@@ -11,6 +11,39 @@ const ABORT_BUDGET_DIVISOR = 6;
11
11
  * Vorgabe 30 s. Ein Storno geht ueber den Host und darf Sekunden brauchen.
12
12
  */
13
13
  const REVERSAL_BUDGET_DIVISOR = 3;
14
+ /**
15
+ * Gruende, die ein Storno als NICHT ausgefuehrt ausweisen -- Teil der
16
+ * Positivliste in [stornoAbgewiesen], jeder Eintrag einzeln begruendet:
17
+ * - `cancelDenied` (`9023` "Cancel Denied, TX already cleared", `9222`
18
+ * "Offline Tx Cancellation Denied"): TECS lehnt genau diese Aufhebung ab.
19
+ * - `amountInvalid` (`9003`, `100019` gemessen an Zahlungen, `9012`, `9026`,
20
+ * `13`, `64`, `87`, `3031` dokumentiert): der Vorgang ueber diesen Betrag
21
+ * wird abgewiesen und nicht ausgefuehrt.
22
+ */
23
+ const STORNO_ABGEWIESEN_GRUENDE = new Set(['cancelDenied', 'amountInvalid']);
24
+ /**
25
+ * `true` nur, wenn die Antwort auf das Storno nach einer AUSDRUECKLICHEN
26
+ * Positivliste sagt, dass es nicht ausgefuehrt wurde:
27
+ *
28
+ * - jeder schluessige Code mit `rejectsRequest` -- die Anfrage selbst wurde
29
+ * abgewiesen (Form, TID, Vorgangstyp, Geraetezustand, `100998`/`8014`
30
+ * "beschaeftigt"), bevor etwas geschah. Gemessen ist davon `9002` "Invalid
31
+ * Transaction" auf eine unbekannte Kennung (27.08.2026); die uebrigen stehen
32
+ * so in der Codeliste von hobex bzw. TECS.
33
+ * - jeder Code mit einem Grund aus [STORNO_ABGEWIESEN_GRUENDE].
34
+ *
35
+ * Alles andere kann gewirkt haben, ausdruecklich auch ein Code, der selbst
36
+ * "storniert" oder "aufgehoben" heisst (`8009` "Technical cancellation",
37
+ * `100029`, `3053`-`3063` "Reversed internally", `9032` "reversed
38
+ * automatically", `9011`), ein Abbruch-Code (`100002`, `17`, `8004`), eine
39
+ * Host-Ablehnung (etwa `05`) und jeder unbekannte Code.
40
+ */
41
+ function stornoAbgewiesen(res) {
42
+ const info = (0, transaction_response_js_1.hpsCodeInfo)(res.responseCode);
43
+ if (info === undefined || !info.conclusive || info.code === transaction_response_js_1.APPROVED_CODE)
44
+ return false;
45
+ return info.rejectsRequest || STORNO_ABGEWIESEN_GRUENDE.has(info.reason);
46
+ }
14
47
  function createHpsPayments(client, target, options = {}) {
15
48
  const resolveBudgetMs = options.resolveBudgetMs ?? 90_000;
16
49
  const maxBackoffMs = options.maxBackoffMs ?? 10_000;
@@ -321,9 +354,10 @@ function createHpsPayments(client, target, options = {}) {
321
354
  return doubled > maxBackoffMs ? maxBackoffMs : doubled;
322
355
  }
323
356
  /**
324
- * Versucht den Abbruch GENAU EINMAL. Liefert ein Ergebnis nur im einen
325
- * beweisbaren Fall: Connect quittiert den Abbruch mit `responseCode === '0'`.
326
- * In jedem anderen Fall `null` -- der Aufrufer pollt dann weiter.
357
+ * Schickt den Abbruch GENAU EINMAL und haelt im Nachweis fest, was das
358
+ * Terminal darauf sagt. Entscheidet NIE ueber den Ausgang -- auch nicht mit
359
+ * `'0'`, siehe Klassendoku, "Ein quittierter Abbruch ist keine Aussage". Der
360
+ * Aufrufer fragt danach immer den Status ab.
327
361
  */
328
362
  async function tryAbort(id, steps, elapsedMs) {
329
363
  let res;
@@ -338,32 +372,42 @@ function createHpsPayments(client, target, options = {}) {
338
372
  + 'oder den Abbruch-Endpunkt nicht; beides sagt nichts ueber die Zahlung, Ausgang wird abgefragt'
339
373
  : `Abbruch nicht bestaetigt (${describe(e)}) -- ob er wirkte, ist offen, Ausgang wird abgefragt`);
340
374
  noteUnexpected(e, id);
341
- return null;
375
+ return;
342
376
  }
377
+ steps.push(abbruchQuittung(res));
378
+ }
379
+ /** Nachweistext zur Antwort auf den Abbruch -- keiner davon schliesst auf den Ausgang. */
380
+ function abbruchQuittung(res) {
343
381
  if (res.responseCode === undefined) {
344
- steps.push('Abbruch ohne Ergebniscode quittiert -- das beweist nichts, Ausgang wird abgefragt');
345
- return null;
382
+ return 'Abbruch ohne Ergebniscode quittiert -- das beweist nichts, Ausgang wird abgefragt';
346
383
  }
347
- if (res.responseCode !== '0') {
348
- steps.push((0, transaction_response_js_1.isNotAbortable)(res)
349
- ? `Abbruch abgelehnt (${transaction_response_js_1.NOT_ABORTABLE_CODE}) -- der Vorgang ist nicht mehr abbrechbar, Ausgang wird abgefragt`
350
- : `Abbruch abgelehnt (${res.responseCode}) -- Grund unbekannt, Ausgang wird abgefragt`);
351
- return null;
384
+ if ((0, transaction_response_js_1.isApproved)(res)) {
385
+ return `Abbruch angenommen (${transaction_response_js_1.APPROVED_CODE}) -- das sagt nicht, ob belastet wurde (am 10.11.2026 `
386
+ + 'endete eine Zahlung nach angenommenem Abbruch genehmigt), Ausgang wird abgefragt';
352
387
  }
353
- steps.push('Abbruch bestaetigt -- der Vorgang war noch abbrechbar, es ist nichts belastet');
354
- emit('resolved', steps[steps.length - 1], id);
355
- return { outcome: 'declined', transactionId: id, response: res, reason: 'aborted', steps: [...steps] };
388
+ if ((0, transaction_response_js_1.isNotAbortable)(res)) {
389
+ return `Abbruch abgelehnt (${transaction_response_js_1.NOT_ABORTABLE_CODE}) -- der Vorgang ist nicht mehr abbrechbar, Ausgang wird abgefragt`;
390
+ }
391
+ return `Abbruch abgelehnt (${res.responseCode}) -- Grund unbekannt, Ausgang wird abgefragt`;
356
392
  }
357
393
  /**
358
394
  * Schickt zu einer Zahlung, deren Host-Antwort ausblieb ([anlass] traegt
359
- * `sendReversal`), GENAU EINMAL ein Storno nach. Ergebnis nur, wenn das
360
- * Terminal es mit `'0'` quittiert; sonst `null`. Ohne [amountCents]
361
- * (Gutschrift) wird nichts gesendet.
395
+ * `sendReversal`), GENAU EINMAL ein Storno ueber [amountCents] nach
396
+ * (Betrag samt Trinkgeld) und haelt im Nachweis fest, was das Terminal
397
+ * darauf sagt. Entscheidet NIE ueber den Ausgang, siehe Klassendoku,
398
+ * "Storno nach ausbleibender Host-Antwort".
399
+ *
400
+ * Liefert, was das Storno bewirkt haben kann ([StornoAusgang]).
401
+ * `nichtGesendet` bei einem [HpsPreflightError]: Connect hat es vor jedem
402
+ * Terminal-Kontakt abgewiesen, beweisbar ist nichts hinausgegangen (siehe
403
+ * `errors.ts`). `abgewiesen` bei HTTP 409: das Terminal nimmt waehrend
404
+ * eines anderen Vorgangs keine Anfrage an (gemessen, ohne Spur; dieselbe
405
+ * Lesart wie fuer die erzeugende Anfrage in [fromTerminalBusy]).
362
406
  */
363
407
  async function sendReversal(id, steps, elapsedMs, amountCents, anlass) {
364
408
  if (amountCents === undefined) {
365
409
  steps.push('Kein Storno nachgeschickt -- die Aufhebung einer Gutschrift laesst TECS nicht zu');
366
- return null;
410
+ return 'nichtGesendet';
367
411
  }
368
412
  emit('resolving', `Storno wird nachgeschickt (${anlass.responseCode})`, id);
369
413
  let res;
@@ -371,19 +415,33 @@ function createHpsPayments(client, target, options = {}) {
371
415
  res = await withinBudget(elapsedMs, () => client.cancel({ ...target, transactionId: id, amountCents }), reversalBudgetMs);
372
416
  }
373
417
  catch (e) {
418
+ if (e instanceof errors_js_1.HpsPreflightError) {
419
+ steps.push(`Storno nicht gesendet (${describe(e)}) -- Kasseneck Connect hat es vor dem Terminal abgewiesen, `
420
+ + 'es kann nicht gewirkt haben, Ausgang wird abgefragt');
421
+ return 'nichtGesendet';
422
+ }
423
+ if (e instanceof errors_js_1.HpsConnectTerminalError && e.isTerminalBusy) {
424
+ steps.push('Storno nicht angenommen (HTTP 409) -- das Terminal war beschaeftigt, es kann nicht gewirkt haben, '
425
+ + 'Ausgang wird abgefragt');
426
+ return 'abgewiesen';
427
+ }
374
428
  steps.push(`Storno nachgeschickt, aber nicht bestaetigt (${describe(e)}) -- ob es wirkte, ist offen, Ausgang wird abgefragt`);
375
429
  noteUnexpected(e, id);
376
- return null;
430
+ return 'kannGewirkt';
377
431
  }
378
- if (!(0, transaction_response_js_1.isApproved)(res)) {
379
- const titel = (0, transaction_response_js_1.hpsCodeInfo)(res.responseCode)?.title;
380
- steps.push(`Storno nachgeschickt, nicht bestaetigt (${res.responseCode ?? 'ohne Ergebniscode'}`
381
- + `${titel === undefined ? '' : ` "${titel}"`}) -- Ausgang wird abgefragt`);
382
- return null;
432
+ if ((0, transaction_response_js_1.isApproved)(res)) {
433
+ steps.push(`Storno nachgeschickt und quittiert (${transaction_response_js_1.APPROVED_CODE}) -- das allein beweist nicht, dass die Zahlung `
434
+ + 'aufgehoben ist, Ausgang wird abgefragt');
435
+ return 'kannGewirkt';
383
436
  }
384
- steps.push('Storno nachgeschickt und bestaetigt -- die Zahlung ist aufgehoben, es ist nichts belastet');
385
- emit('resolved', steps[steps.length - 1], id);
386
- return { outcome: 'declined', transactionId: id, response: res, reason: 'voidedAfterHostFault', steps: [...steps] };
437
+ const titel = (0, transaction_response_js_1.hpsCodeInfo)(res.responseCode)?.title;
438
+ const code = `${res.responseCode ?? 'ohne Ergebniscode'}${titel === undefined ? '' : ` "${titel}"`}`;
439
+ if (stornoAbgewiesen(res)) {
440
+ steps.push(`Storno abgewiesen (${code}) -- es wurde nicht ausgefuehrt, Ausgang wird abgefragt`);
441
+ return 'abgewiesen';
442
+ }
443
+ steps.push(`Storno nachgeschickt, nicht bestaetigt (${code}) -- ob es wirkte, ist offen, Ausgang wird abgefragt`);
444
+ return 'kannGewirkt';
387
445
  }
388
446
  /**
389
447
  * Klaert einen offenen Ausgang: erst abbrechen, dann abfragen -- bis das
@@ -396,6 +454,10 @@ function createHpsPayments(client, target, options = {}) {
396
454
  * [ausGeschlossenerAntwort]. Meldet sie eine Stoerung beim Host
397
455
  * ([isHostUncertain]), bekommt `9027` diesen Aussagewert gerade NICHT --
398
456
  * siehe Klassendoku, "Stoerung beim Host".
457
+ *
458
+ * [stornoCents] ist, was ein nachgeschicktes Storno aufheben muss: Betrag
459
+ * samt Trinkgeld der Zahlung. Nur [pay] setzt ihn; ohne ihn wird kein
460
+ * Storno gesendet.
399
461
  */
400
462
  async function resolve(id, steps, antwort, stornoCents) {
401
463
  emit('resolving', 'Ausgang offen, Klaerung laeuft', id);
@@ -406,25 +468,26 @@ function createHpsPayments(client, target, options = {}) {
406
468
  // Statusabfrage sie nennt und danach 9027 kommt.
407
469
  let stoerungsAntwort = antwort && (0, transaction_response_js_1.isHostUncertain)(antwort) ? antwort : undefined;
408
470
  let letzteAntwort = antwort;
409
- // Das Storno wird hoechstens einmal erwogen; gesendet ist es nur mit Betrag.
471
+ // Das Storno wird hoechstens einmal erwogen; versucht wird es nur mit
472
+ // Betrag, also nur fuer eine Zahlung.
410
473
  let stornoErwogen = false;
411
- let stornoGesendet = false;
474
+ let stornoVersucht = false;
475
+ // Was das Storno bewirkt haben kann; `kannGewirkt` nimmt auch einer
476
+ // Genehmigung in der Statusabfrage die Aussage.
477
+ let storno;
412
478
  if (stoerungsAntwort === undefined) {
413
- const aborted = await tryAbort(id, steps, elapsedMs);
414
- if (aborted)
415
- return aborted;
479
+ // Entscheidet nichts, beendet nur einen noch wartenden Kartenfluss.
480
+ await tryAbort(id, steps, elapsedMs);
416
481
  }
417
482
  else {
418
483
  // Der Vorgang ist am Terminal schon beendet -- mit einer Stoerung beim
419
- // Host. Ein quittierter Abbruch bewiese nur, dass am Terminal nichts mehr
420
- // laeuft, nicht, dass der Host nichts belastet hat.
484
+ // Host. Es gibt nichts mehr abzubrechen, und eine Quittung saehe
485
+ // ohnehin nur das Terminal, nicht den Host.
421
486
  steps.push('Kein Abbruchversuch -- das Terminal hat den Vorgang mit einer Stoerung beim hobex-Host beendet');
422
487
  if ((0, transaction_response_js_1.needsReversal)(stoerungsAntwort)) {
423
488
  stornoErwogen = true;
424
- stornoGesendet = stornoCents !== undefined;
425
- const storniert = await sendReversal(id, steps, elapsedMs, stornoCents, stoerungsAntwort);
426
- if (storniert)
427
- return storniert;
489
+ stornoVersucht = stornoCents !== undefined;
490
+ storno = await sendReversal(id, steps, elapsedMs, stornoCents, stoerungsAntwort);
428
491
  }
429
492
  }
430
493
  let wait = 0;
@@ -460,30 +523,46 @@ function createHpsPayments(client, target, options = {}) {
460
523
  if ((0, transaction_response_js_1.isHostUncertain)(status))
461
524
  stoerungsAntwort ??= status;
462
525
  const hostUngewiss = stoerungsAntwort !== undefined;
463
- if (stornoGesendet && (0, transaction_response_js_1.isCanceled)(status)) {
464
- steps.push(`Status: Zahlung aufgehoben (${transaction_response_js_1.TRANSACTION_CANCELED_CODE}) -- das nachgeschickte Storno hat gegriffen, `
465
- + 'es ist nichts belastet');
526
+ if (stornoVersucht && (0, transaction_response_js_1.isCanceled)(status)) {
527
+ // Aufgehoben ist aufgehoben. Wer es war, behauptet der Nachweis nur so
528
+ // weit, wie es feststeht: hat das Storno nachweislich nicht gewirkt,
529
+ // war es ein anderer Vorgang, und der Grund ist `canceled`.
530
+ const durchsStorno = storno === 'kannGewirkt';
531
+ steps.push(durchsStorno
532
+ ? `Status: Zahlung aufgehoben (${transaction_response_js_1.TRANSACTION_CANCELED_CODE}) nach dem nachgeschickten Storno -- `
533
+ + 'es ist nichts belastet'
534
+ : `Status: Zahlung aufgehoben (${transaction_response_js_1.TRANSACTION_CANCELED_CODE}), obwohl das nachgeschickte Storno nicht `
535
+ + 'ausgefuehrt wurde -- es ist nichts belastet');
466
536
  emit('resolved', steps[steps.length - 1], id);
467
- return { outcome: 'declined', transactionId: id, response: status, reason: 'voidedAfterHostFault', steps: [...steps] };
537
+ return {
538
+ outcome: 'declined',
539
+ transactionId: id,
540
+ response: status,
541
+ reason: durchsStorno ? 'voidedAfterHostFault' : 'canceled',
542
+ steps: [...steps],
543
+ };
468
544
  }
469
545
  if (!stornoErwogen && (0, transaction_response_js_1.needsReversal)(status)) {
470
546
  // Die Zahlung selbst kam ohne Antwort zurueck, erst die Statusabfrage
471
547
  // nennt die ausgebliebene Host-Antwort -- dasselbe Storno wie oben.
472
548
  steps.push(statusOhneErgebnis(status));
473
549
  stornoErwogen = true;
474
- stornoGesendet = stornoCents !== undefined;
475
- const storniert = await sendReversal(id, steps, elapsedMs, stornoCents, status);
476
- if (storniert)
477
- return storniert;
550
+ stornoVersucht = stornoCents !== undefined;
551
+ storno = await sendReversal(id, steps, elapsedMs, stornoCents, status);
478
552
  wait = nextWait(wait);
479
553
  continue;
480
554
  }
555
+ // Nach einem Storno, das gewirkt haben kann, sagt auch '0' nichts: das
556
+ // Storno kann noch unterwegs sein oder nicht gegriffen haben. Es zaehlt
557
+ // unten als "nichts Neues" -- siehe Klassendoku, "Storno nach
558
+ // ausbleibender Host-Antwort".
559
+ const genehmigtTrotzStorno = storno === 'kannGewirkt' && (0, transaction_response_js_1.isApproved)(status);
481
560
  // Auf die Statusabfrage entscheidet nur ein Code, der den gesuchten
482
561
  // Vorgang beschreibt -- nicht einer, der diese Abfrage abweist
483
562
  // ([isConclusiveAsStatus]). Nach einer Stoerung beim Host entscheidet nur
484
563
  // noch eine Genehmigung: jede andere Aussage des Terminals betrifft seinen
485
564
  // Speicher, nicht den des Hosts.
486
- if (hostUngewiss ? (0, transaction_response_js_1.isApproved)(status) : (0, transaction_response_js_1.isConclusiveAsStatus)(status)) {
565
+ if (!genehmigtTrotzStorno && (hostUngewiss ? (0, transaction_response_js_1.isApproved)(status) : (0, transaction_response_js_1.isConclusiveAsStatus)(status))) {
487
566
  const settled = fromResponse(status, id, steps);
488
567
  if (settled)
489
568
  return settled;
@@ -500,9 +579,12 @@ function createHpsPayments(client, target, options = {}) {
500
579
  ohneAuskunft = 0;
501
580
  }
502
581
  // Nach einer Stoerung ist jede Antwort ausser '0' (die oben schon
503
- // entschieden hat) "nichts Neues".
582
+ // entschieden hat) "nichts Neues" -- nach einem Storno auch '0'.
504
583
  stoerungOhneNeues = hostUngewiss ? stoerungOhneNeues + 1 : 0;
505
- steps.push(statusOhneErgebnis(status) ?? 'Status: noch kein Ergebniscode');
584
+ steps.push(genehmigtTrotzStorno
585
+ ? `Status: Zahlung steht unveraendert (${transaction_response_js_1.APPROVED_CODE}) -- das nachgeschickte Storno kann noch `
586
+ + 'unterwegs sein oder nicht gegriffen haben, keine Aussage'
587
+ : statusOhneErgebnis(status) ?? 'Status: noch kein Ergebniscode');
506
588
  if (stoerungOhneNeues >= 2) {
507
589
  // Siehe Klassendoku, "Stoerung beim Host": das Terminal weiss es
508
590
  // nicht, und es wird es auch nicht wissen, wenn wir weiterfragen.
@@ -528,7 +610,7 @@ function createHpsPayments(client, target, options = {}) {
528
610
  * wurde uns gerade geantwortet. Uebrig bleibt "beendet und nicht genehmigt".
529
611
  *
530
612
  * **Gegenprobe** (28.08.2026, TID 3600335, jeweils nach abgeschlossenem
531
- * Vorgang): genehmigt (Beleg 408811) -> Statusabfrage `0`, dreimal
613
+ * Vorgang): genehmigt -> Statusabfrage `0`, dreimal
532
614
  * wiederholt; abgelehnt mit `100003` -> `9027`, zweimal; abgelehnt mit
533
615
  * `9003` -> `9027`. Eine genehmigte Zahlung antwortet also nicht `9027`.
534
616
  *
@@ -679,7 +761,8 @@ function createHpsPayments(client, target, options = {}) {
679
761
  return settled;
680
762
  steps.push(offeneAntwort(res));
681
763
  }
682
- return resolve(id, steps, res, paymentOptions.amountCents);
764
+ // Ein Storno hebt auf, was das Terminal belastet hat: Betrag UND Trinkgeld.
765
+ return resolve(id, steps, res, paymentOptions.amountCents + (paymentOptions.tipCents ?? 0));
683
766
  }
684
767
  /**
685
768
  * Gutschrift mit geklaertem Ausgang -- EXAKT derselbe Klaerweg wie [pay]
@@ -721,8 +804,9 @@ function createHpsPayments(client, target, options = {}) {
721
804
  steps.push(offeneAntwort(res));
722
805
  }
723
806
  // Dieselbe Klaerfunktion wie [pay]: die Kennung ist die des NEUEN
724
- // Vorgangs, eine Statusabfrage darauf liefert also genau dessen Ausgang,
725
- // und der Abbruch ist derselbe Diskriminator wie bei einer Zahlung.
807
+ // Vorgangs, eine Statusabfrage darauf liefert also genau dessen Ausgang.
808
+ // Der Abbruch entscheidet hier so wenig wie bei einer Zahlung, und ohne
809
+ // Betrag schickt die Klaerung kein Storno nach.
726
810
  return resolve(id, steps, res);
727
811
  }
728
812
  /**