@fire-spark/payments-clisitef-pinpad-rn 0.7.2 → 0.8.0

package/dist/index.js

@@ -1,11 +1,11 @@
 import { PaymentError, createPaymentError, definePaymentErrors, toPaymentError } from "@fire-spark/payments";
-import { CLISITEF_ABORT_FLAG, CLISITEF_CONFIRM, CLISITEF_MODALITY, CLISITEF_RESULT, CLISITEF_TIMEOUT_CODE, clisitef, clisitefAdditionalParams, clisitefDebug, clisitefDebugCall, clisitefFiscalDateTime, formatClisitefAmount, parseClisitefMenu } from "@fire-spark/payments-clisitef-client";
+import { CLISITEF_ABORT_FLAG, CLISITEF_CONFIRM, CLISITEF_MODALITY, CLISITEF_RESULT, CLISITEF_TIMEOUT_CODE, CLISITEF_VOID_FUNCTION, clisitef, clisitefAdditionalParams, clisitefDebug, clisitefDebugCall, clisitefFiscalDateTime, formatClisitefAmount, parseClisitefMenu } from "@fire-spark/payments-clisitef-client";
 //#region src/constants.ts
 /**
 * `onData` commands handled by the adapter (Fiserv "Tabela de códigos de
 * comando"). Not handled, so they abort the transaction: 29 (silent field),
-* 31 (check), 35 (barcode), 42 (identified menu, only with
-* `ItemMenuIdentificado`) and 50/51 (QR, PIX only).
+* 31 (check), 35 (barcode) and 42 (identified menu, only with
+* `ItemMenuIdentificado`).
 */
 const CLISITEF_COMMAND = {
 	STORE_FIELD: 0,
@@ -26,6 +26,9 @@ const CLISITEF_COMMAND = {
 	READ_FIELD: 30,
 	READ_AMOUNT: 34,
 	READ_MASKED: 41,
+	/** PIX: show the QR (`fieldId` 584 carries the copy-and-paste payload). */
+	QR_SHOW: 50,
+	QR_HIDE: 51,
 	FOOTER: 52
 };
 /** `continueTransaction` answers to `CONFIRM` (20). */
@@ -43,9 +46,17 @@ const CLISITEF_FIELD = {
 	AUTHORIZATION_CODE: 135,
 	CARD_BIN: 136,
 	INSTITUTION_NAME: 156,
+	QR_PAYLOAD: 584,
 	LAST4: 1190,
 	ENTRY_MODE: 2090
 };
+/** Fields a void asks for (`READ_*` commands), answered without the UI. */
+const CLISITEF_VOID_FIELD = {
+	AMOUNT: 146,
+	SUPERVISOR_PASSWORD: 500,
+	ORIGINAL_DATE: 515,
+	ORIGINAL_HOST_NSU: 516
+};
 /** Fields that prove the card was read: an error after them is ambiguous. */
 const CLISITEF_CAPTURE_FIELDS = /* @__PURE__ */ new Set([
 	CLISITEF_FIELD.CUSTOMER_RECEIPT,
@@ -80,6 +91,12 @@ const CLISITEF_PAYMENT_TIMEOUT_MS = 18e4;
 const CLISITEF_DEFAULT_OPERATOR = "KIOSKO_BR";
 /** Device-wide record of the last transaction, to undo it after a crash. */
 const CLISITEF_STORAGE_KEY = "clisitef:transaction:v1";
+/** Device-wide record of the last refund, apart from the charge one. */
+const CLISITEF_REFUND_STORAGE_KEY = "clisitef:refund:v1";
+/** Device-wide queue of voids that did not complete, retried later. */
+const CLISITEF_REVERSALS_KEY = "clisitef:reversals:v1";
+/** Device-wide record of completed voids, by attempt reference. */
+const CLISITEF_REFUNDS_KEY = "clisitef:refunds:v1";
 //#endregion
 //#region src/errors.ts
 const source = "docs/payments/clisitef/pinpad.md#11-errores";
@@ -110,14 +127,18 @@ const clisitefPinPadErrors = definePaymentErrors({
 	"-15": entry("CANCELLED_BY_USER"),
 	"-20": invalid("Invalid CliSiTef parameter"),
 	"-21": invalid("Prohibited word in pinpad collection"),
-	"-24": invalid("Digital wallet not enabled"),
+	"-24": entry("WALLET_REJECTED", {
+		message: "Digital wallet not enabled",
+		retryable: false
+	}),
 	"-30": entry("TERMINAL_UNAVAILABLE", { message: "File access error" }),
 	"-40": entry("CARD_DECLINED", { message: "Declined by the SiTef server" }),
 	"-41": invalid("Invalid data"),
 	"-43": entry("TERMINAL_UNAVAILABLE", { message: "Pinpad routine failed" }),
 	"-50": entry("FRAUD_SUSPECTED", { message: "Unsecured transaction" }),
 	"-100": entry("UNKNOWN", { message: "CliSiTef internal error" }),
-	[CLISITEF_TIMEOUT_CODE]: entry("TIMEOUT")
+	[CLISITEF_TIMEOUT_CODE]: entry("TIMEOUT"),
+	FINANCING_ONLY: invalid("Only deferred payment offered by SiTef")
 });
 //#endregion
 //#region src/metadata.ts
@@ -164,27 +185,43 @@ const CARD_TYPES = {
 	VOUCHER: "PREPAID",
 	PIX: null
 };
-const clisitefMetadata = (input) => {
+/** A PIX charge has no card: never take brand or last 4 from its receipt. */
+const cardOf = (input, receipt) => {
 	const { fields } = input;
+	const entry = field(fields, CLISITEF_FIELD.ENTRY_MODE);
+	if (input.modality === "PIX") return {
+		brand: null,
+		last4: null,
+		entry_mode: "QR"
+	};
+	const last4 = field(fields, CLISITEF_FIELD.LAST4)?.slice(-4) ?? null;
+	return {
+		brand: clisitefBrand(fields),
+		last4: last4 ?? clisitefLast4(receipt),
+		entry_mode: entry ? ENTRY_MODES[entry] ?? null : null
+	};
+};
+const receiptOf = (fields) => {
 	const customer = field(fields, CLISITEF_FIELD.CUSTOMER_RECEIPT);
 	const merchant = field(fields, CLISITEF_FIELD.MERCHANT_RECEIPT);
-	const brand = clisitefBrand(fields);
-	const last4 = field(fields, CLISITEF_FIELD.LAST4)?.slice(-4) ?? null;
-	const entry = field(fields, CLISITEF_FIELD.ENTRY_MODE);
+	if (customer === null && merchant === null) return void 0;
+	return {
+		customer,
+		merchant,
+		format: "text"
+	};
+};
+const clisitefMetadata = (input) => {
+	const { fields } = input;
+	const receipt = receiptOf(fields);
 	const institution = field(fields, CLISITEF_FIELD.INSTITUTION_NAME);
 	const p1 = {
 		provider_transaction_id: field(fields, CLISITEF_FIELD.SITEF_NSU),
 		authorization_code: field(fields, CLISITEF_FIELD.AUTHORIZATION_CODE),
 		reference: field(fields, CLISITEF_FIELD.HOST_NSU)
 	};
-	const p2 = {
-		card_type: CARD_TYPES[input.modality] ?? null,
-		brand
-	};
-	const p3 = {
-		last4: last4 ?? clisitefLast4(customer ?? merchant),
-		entry_mode: entry ? ENTRY_MODES[entry] ?? null : null
-	};
+	const p2 = { card_type: CARD_TYPES[input.modality] ?? null };
+	const p3 = cardOf(input, receipt?.customer ?? receipt?.merchant ?? null);
 	const p4 = { acquirer: institution ?? field(fields, CLISITEF_FIELD.INSTITUTION_CODE) };
 	const p5 = { terminal_id: input.terminalNumber };
 	const p6 = { ticket_number: input.fiscalCoupon };
@@ -198,17 +235,39 @@ const clisitefMetadata = (input) => {
 		...p6,
 		...p7
 	};
-	const receipt = customer !== null || merchant !== null ? {
-		customer,
-		merchant,
-		format: "text"
-	} : void 0;
+	const fn = CLISITEF_MODALITY[input.modality];
+	const provider = {
+		modality: input.modality,
+		function: fn
+	};
 	return {
 		attempt_reference: input.attemptReference,
 		payment,
-		receipt
+		receipt,
+		provider
+	};
+};
+/** Void data kept under `provider.void`, next to the charge's metadata. */
+const clisitefVoidMetadata = (input) => {
+	const { fields } = input;
+	return {
+		function: input.function,
+		provider_transaction_id: field(fields, CLISITEF_FIELD.SITEF_NSU),
+		reference: field(fields, CLISITEF_FIELD.HOST_NSU),
+		ticket_number: input.fiscalCoupon,
+		transaction_date: input.fiscalDate,
+		receipt: receiptOf(fields) ?? null
 	};
 };
+/** Spark modality of a charge; older charges only kept `card_type`. */
+const clisitefModalityOf = (metadata) => {
+	const stored = metadata.provider?.modality;
+	if (typeof stored === "string" && stored in CLISITEF_MODALITY) return stored;
+	const cardType = metadata.payment?.card_type;
+	if (cardType === "PREPAID") return "VOUCHER";
+	if (cardType === "DEBIT" || cardType === "CREDIT") return cardType;
+	return null;
+};
 /** PIN_PAD tender details; `null` without brand and last 4 (schema minimum). */
 const clisitefDetails = (metadata) => {
 	const payment = metadata.payment;
@@ -225,138 +284,115 @@ const clisitefDetails = (metadata) => {
 	};
 };
 //#endregion
-//#region src/settings.ts
-const CLISITEF_PINPAD_TYPES = [
-	"ANDROID_USB",
-	"ANDROID_BT",
-	"ANDROID_AUTO"
-];
-/**
-* Ficha §6: filled per kiosk in the device settings. SiTef IP, store code
-* and store CNPJ come from the payment's store settings (`config.stores`);
-* the device values only override them.
-*/
-const clisitefPinPadDeviceFields = [{
-	key: "terminal_number",
-	label: "SiTef terminal number",
-	type: "text",
-	required: true
-}, {
-	key: "pinpad_type",
-	label: "Pinpad connection",
-	type: "select",
-	options: [...CLISITEF_PINPAD_TYPES]
-}];
-/** The API only sends the entry of the kiosk's store. */
-const storeSettingsOf = (config) => {
-	const stores = config.stores;
-	if (!stores || typeof stores !== "object") return {};
-	const [first] = Object.values(stores);
-	return first && typeof first === "object" ? first : {};
+//#region src/reversals.ts
+const readJson = async (storage, key) => {
+	const raw = await storage.get(key);
+	if (!raw) return null;
+	try {
+		return JSON.parse(raw);
+	} catch {
+		return null;
+	}
 };
-const text = (value) => {
-	return typeof value === "string" ? value.trim() : "";
+const readPendingReversals = async (storage) => {
+	const list = await readJson(storage, CLISITEF_REVERSALS_KEY);
+	return Array.isArray(list) ? list : [];
 };
-const notConfigured = (missing) => {
-	return new PaymentError(createPaymentError("TERMINAL_NOT_CONFIGURED", { message: `CliSiTef is missing ${missing.join(", ")}` }));
+const writePendingReversals = async (storage, list) => {
+	if (!list.length) return storage.remove(CLISITEF_REVERSALS_KEY);
+	await storage.set(CLISITEF_REVERSALS_KEY, JSON.stringify(list));
 };
-const isModality = (value) => {
-	return value === "DEBIT" || value === "CREDIT" || value === "VOUCHER";
+/** Adds the void or bumps its attempts. */
+const queueReversal = async (storage, entry, now) => {
+	const list = await readPendingReversals(storage);
+	const reference = entry.attemptReference;
+	const previous = list.find((item) => item.attemptReference === reference);
+	const rest = list.filter((item) => item.attemptReference !== reference);
+	const attempts = (previous?.attempts ?? 0) + 1;
+	const createdAt = previous?.createdAt ?? now;
+	await writePendingReversals(storage, [...rest, {
+		...entry,
+		attempts,
+		createdAt
+	}]);
 };
-/** `modalities`, or the legacy single `modality` of older configs. */
-const listModalities = (config) => {
-	const listed = Array.isArray(config.modalities) ? config.modalities : [];
-	return (listed.length ? listed : [config.modality]).map(text).filter(Boolean);
+const dropReversal = async (storage, attemptReference) => {
+	const list = await readPendingReversals(storage);
+	const rest = list.filter((item) => item.attemptReference !== attemptReference);
+	if (rest.length !== list.length) await writePendingReversals(storage, rest);
 };
-/** Per modality; the legacy `restrictions` applies to all of them. */
-const readRestrictions = (config, modalities) => {
-	const raw = config.restrictions_by_modality;
-	const byModality = raw && typeof raw === "object" ? raw : {};
-	const legacy = text(config.restrictions);
-	const entries = modalities.map((modality) => {
-		return [modality, text(byModality[modality]) || legacy];
-	});
-	return Object.fromEntries(entries.filter(([, value]) => value));
+const readRefund = async (storage, attemptReference) => {
+	return (await readJson(storage, "clisitef:refunds:v1"))?.[attemptReference] ?? null;
 };
-/** `payments.config` (merchant) + device settings; throws when incomplete. */
-const readClisitefPinPadSettings = (config, device) => {
-	const listed = listModalities(config);
-	const cnpjEnterprise = text(config.cnpj_enterprise);
-	const store = storeSettingsOf(config);
-	const serverIp = text(device.sitef_ip) || text(store.sitef_ip);
-	const storeCode = text(device.store_code) || text(store.store_code);
-	const terminalNumber = text(device.terminal_number);
-	const cnpjStore = (text(device.cnpj_store) || text(store.cnpj_store)).replace(/\D/g, "");
-	const pinpadType = text(device.pinpad_type) || void 0;
-	const required = {
-		modalities: listed.join(","),
-		cnpj_enterprise: cnpjEnterprise
-	};
-	const fromDevice = {
-		sitef_ip: serverIp,
-		store_code: storeCode
-	};
-	const more = {
-		terminal_number: terminalNumber,
-		cnpj_store: cnpjStore
-	};
-	const values = {
-		...required,
-		...fromDevice
+const writeRefund = async (storage, attemptReference, result) => {
+	const refunds = await readJson(storage, "clisitef:refunds:v1") ?? {};
+	const kept = Object.entries(refunds).filter(([key]) => {
+		return key !== attemptReference;
+	}).slice(-49);
+	const next = Object.fromEntries([...kept, [attemptReference, result]]);
+	await storage.set(CLISITEF_REFUNDS_KEY, JSON.stringify(next));
+};
+//#endregion
+//#region src/menu.ts
+const normalize = (label) => {
+	return label.normalize("NFD").replace(/[\u0300-\u036f]/g, "").toUpperCase();
+};
+/** No voucher matcher: its brand menu is always shown. */
+const MATCHERS = {
+	DEBIT: /DEBITO/,
+	CREDIT: /CREDITO/,
+	PIX: /PIX|QR|DIGITAL/
+};
+/** Debit and credit are already picked in the kiosk UI before the charge. */
+const PRESELECTED = /* @__PURE__ */ new Set(["DEBIT", "CREDIT"]);
+const SPOT = /A VISTA/;
+const FINANCING = /PARCEL|PRE[\s-]?DATAD|CREDIARIO|JUROS|DIFERID/;
+const matching = (options, pattern) => {
+	return options.filter((option) => pattern.test(normalize(option.label)));
+};
+/** The kiosk has no deferred payment: spot over financing, never financing. */
+const chargeMenu = (options) => {
+	const financing = matching(options, FINANCING);
+	if (!financing.length) return {
+		kind: "ask",
+		options
 	};
-	Object.assign(values, more);
-	const missing = Object.keys(values).filter((key) => !values[key]);
-	clisitefDebug("pinpad.settings", "read", {
-		config,
-		device,
-		missing
+	const [spot] = matching(options, SPOT).filter((option) => {
+		return !financing.includes(option);
 	});
-	if (missing.length) throw notConfigured(missing);
-	if (!listed.every(isModality)) throw notConfigured(["a valid modality"]);
-	const configure = {
-		serverIp,
-		storeCode,
-		terminalNumber,
-		additionalParams: clisitefAdditionalParams({
-			cnpjStore,
-			cnpjEnterprise,
-			pinpadType
-		})
+	if (spot) return {
+		kind: "pick",
+		value: spot.value
+	};
+	const rest = options.filter((option) => !financing.includes(option));
+	if (!rest.length) return {
+		kind: "abort",
+		message: "Only deferred payment offered"
 	};
-	const operator = text(config.operator) || "KIOSKO_BR";
-	const unique = [...new Set(listed)];
 	return {
-		configure,
-		modalities: unique,
-		operator,
-		restrictions: readRestrictions(config, unique),
-		terminalNumber
+		kind: "ask",
+		options: rest
 	};
 };
-//#endregion
-//#region src/store.ts
-const isRecord = (value) => {
-	if (!value || typeof value !== "object") return false;
-	const record = value;
-	return typeof record.fiscalCoupon === "string" && typeof record.attemptReference === "string";
-};
-const readTransaction = async (storage) => {
-	const raw = await storage.get(CLISITEF_STORAGE_KEY);
-	clisitefDebug("pinpad.store", "read", { raw });
-	if (!raw) return null;
-	try {
-		const parsed = JSON.parse(raw);
-		return isRecord(parsed) ? parsed : null;
-	} catch {
-		return null;
-	}
-};
-const writeTransaction = async (storage, record) => {
-	clisitefDebug("pinpad.store", `write ${record.state}`, record);
-	await storage.set(CLISITEF_STORAGE_KEY, JSON.stringify(record));
-};
-const isOpen = (record) => {
-	return record.state === "started" || record.state === "approved";
+/**
+* Command 21. Labels compare without accents and in upper case. A void
+* picks the original modality when one option matches it; a charge does it
+* only for debit and credit, then drops the financing options.
+*/
+const resolveClisitefMenu = (options, modality, purpose) => {
+	const matcher = MATCHERS[modality];
+	const preselected = purpose === "void" || PRESELECTED.has(modality);
+	const matched = matcher && preselected ? matching(options, matcher) : [];
+	const [only] = matched;
+	if (matched.length === 1 && only) return {
+		kind: "pick",
+		value: only.value
+	};
+	if (purpose === "void") return {
+		kind: "ask",
+		options
+	};
+	return chargeMenu(matched.length ? matched : options);
 };
 //#endregion
 //#region src/transaction.ts
@@ -373,6 +409,11 @@ const inputType = (command) => {
 	if (command === CLISITEF_COMMAND.READ_AMOUNT) return "number";
 	return "text";
 };
+/** `"AGUARDE, EM PROCESSAMENTO (3)"` → `"AGUARDE, EM PROCESSAMENTO"`. */
+const COUNTER = /\s*\(\s*\d+\s*\)\s*$/;
+const collapseCounter = (text) => {
+	return text.replace(COUNTER, "").trim() || text;
+};
 const MESSAGES = /* @__PURE__ */ new Set([
 	CLISITEF_COMMAND.MESSAGE_OPERATOR,
 	CLISITEF_COMMAND.MESSAGE_CUSTOMER,
@@ -393,6 +434,16 @@ const READS = /* @__PURE__ */ new Set([
 	CLISITEF_COMMAND.READ_AMOUNT,
 	CLISITEF_COMMAND.READ_MASKED
 ]);
+/** The PIX payload is the charge code and the supervisor password a secret. */
+const redact = (event) => {
+	const qr = event.command === CLISITEF_COMMAND.QR_SHOW;
+	const masked = event.command === CLISITEF_COMMAND.READ_MASKED;
+	if (!qr && !masked && event.fieldId !== CLISITEF_FIELD.QR_PAYLOAD) return event;
+	return {
+		...event,
+		input: `<${event.input.length} chars>`
+	};
+};
 /**
 * One CliSiTef transaction: `startTransaction`, the `onData` loop answered
 * through `ui`, `finishTransaction(1)` on approval (`stage 1` = 0) and
@@ -403,6 +454,7 @@ const runClisitefTransaction = (input) => {
 	const fields = /* @__PURE__ */ new Map();
 	const subscriptions = [];
 	let title = "";
+	let lastMessage = "";
 	let captured = false;
 	let approved = false;
 	let closing = false;
@@ -426,7 +478,7 @@ const runClisitefTransaction = (input) => {
 	const settle = (status, reason) => {
 		log(`settle ${status}`, {
 			...reason,
-			fields: Object.fromEntries(fields)
+			fieldIds: [...fields.keys()]
 		});
 		clearTimeout(watchdog);
 		for (const subscription of subscriptions) subscription.remove();
@@ -435,7 +487,8 @@ const runClisitefTransaction = (input) => {
 			status,
 			...reason,
 			fields,
-			aborted
+			aborted,
+			evidence: captured
 		});
 	};
 	const undo = async (reason) => {
@@ -470,17 +523,73 @@ const runClisitefTransaction = (input) => {
 			message: "Aborted by the payment deadline"
 		});
 	}
-	const reply = async (data) => {
+	const reply = async (data, hidden = false) => {
 		log("reply", {
-			data,
+			data: hidden ? "********" : data,
+			length: data.length,
 			skipped: closing
 		});
 		if (closing) return;
 		await client.continueTransaction(data);
 	};
+	const showMessage = (text) => {
+		const collapsed = collapseCounter(text.trim());
+		if (!collapsed || collapsed === lastMessage) return;
+		lastMessage = collapsed;
+		ui.message({
+			text: collapsed,
+			kind: "waiting"
+		});
+	};
+	const onMenu = async (text) => {
+		const options = parseClisitefMenu(text);
+		const label = title || "Selecione uma opção";
+		const decision = resolveClisitefMenu(...[
+			options,
+			input.modality,
+			input.purpose
+		]);
+		log("menu", {
+			title: label,
+			options,
+			decision
+		});
+		if (decision.kind === "abort") {
+			const reason = {
+				code: "FINANCING_ONLY",
+				message: decision.message
+			};
+			return close(reason);
+		}
+		if (decision.kind === "pick") return reply(decision.value);
+		const p2 = {
+			title: label,
+			options: decision.options
+		};
+		const picked = await ui.select(p2);
+		log("ui.select ← out", { picked });
+		return reply(picked);
+	};
+	const onQr = (event) => {
+		const payload = event.input.trim();
+		const isPayload = event.fieldId === CLISITEF_FIELD.QR_PAYLOAD;
+		log("qr shown", {
+			fieldId: event.fieldId,
+			length: payload.length
+		});
+		if (!isPayload || !payload) return reply("");
+		captured = true;
+		ui.action({
+			type: "qr",
+			payload,
+			format: "text",
+			expiresAt: null
+		});
+		return reply("");
+	};
 	const onData = async (event) => {
 		log("onData", {
-			...event,
+			...redact(event),
 			title
 		});
 		const { command, input: text } = event;
@@ -489,13 +598,20 @@ const runClisitefTransaction = (input) => {
 			if (CLISITEF_CAPTURE_FIELDS.has(event.fieldId)) captured = true;
 			return reply("");
 		}
-		if (MESSAGES.has(command)) {
-			if (text.trim()) ui.message({
-				text: text.trim(),
-				kind: "waiting"
+		if (command === CLISITEF_COMMAND.QR_SHOW) return onQr(event);
+		if (command === CLISITEF_COMMAND.QR_HIDE) {
+			ui.action({
+				type: "qr",
+				payload: "",
+				format: "text",
+				expiresAt: null
 			});
 			return reply("");
 		}
+		if (MESSAGES.has(command)) {
+			showMessage(text);
+			return reply("");
+		}
 		if (command === CLISITEF_COMMAND.MENU_TITLE) {
 			title = text.trim();
 			return reply("");
@@ -511,21 +627,10 @@ const runClisitefTransaction = (input) => {
 			log("ui.confirm ← out", { yes });
 			return reply(yes ? "0" : "1");
 		}
-		if (command === CLISITEF_COMMAND.MENU) {
-			const options = parseClisitefMenu(text);
-			const label = title || "Selecione uma opção";
-			log("ui.select → in", {
-				title: label,
-				options
-			});
-			const picked = await ui.select({
-				title: label,
-				options
-			});
-			log("ui.select ← out", { picked });
-			return reply(picked);
-		}
+		if (command === CLISITEF_COMMAND.MENU) return onMenu(text);
 		if (READS.has(command)) {
+			const known = input.answerField?.(event.fieldId) ?? null;
+			if (known !== null) return reply(known, true);
 			const label = text.trim() || title || "Informe o dado";
 			const max = event.maxLength > 0 ? event.maxLength : void 0;
 			const p1 = {
@@ -535,7 +640,6 @@ const runClisitefTransaction = (input) => {
 			};
 			log("ui.input → in", p1);
 			const value = await ui.input(p1);
-			log("ui.input ← out", { value });
 			return reply(value);
 		}
 		const message = `Unsupported CliSiTef command ${command}`;
@@ -672,6 +776,393 @@ const runClisitefTransaction = (input) => {
 	return done;
 };
 //#endregion
+//#region src/refund.ts
+/**
+* The acquirer or SiTef answered: the transaction is not there, already
+* voided or the void is refused. Retrying does not help.
+*/
+const DEFINITIVE = /* @__PURE__ */ new Set([
+	-3,
+	-10,
+	-13,
+	-20,
+	-40,
+	-41
+]);
+const isDefinitive = (outcome) => {
+	if (outcome.aborted || outcome.error) return false;
+	if (outcome.status === "unresolved") return false;
+	const { code } = outcome;
+	if (typeof code !== "number") return false;
+	return code > 0 || DEFINITIVE.has(code);
+};
+/** `YYYYMMDD` (fiscal date of the charge) → `DDMMYYYY` (field 515). */
+const toDdMmYyyy = (date) => {
+	return `${date.slice(6, 8)}${date.slice(4, 6)}${date.slice(0, 4)}`;
+};
+const targetOf = (result) => {
+	const payment = result.metadata.payment;
+	const modality = clisitefModalityOf(result.metadata);
+	const hostNsu = payment?.reference?.trim();
+	const transactionDate = payment?.transaction_date?.trim();
+	if (!modality || !hostNsu || !transactionDate) return null;
+	if (!/^\d{8}$/.test(transactionDate)) return null;
+	return {
+		reference: result.metadata.attempt_reference,
+		modality,
+		hostNsu,
+		transactionDate
+	};
+};
+/** The charge stays in force: `PAID`, flagged for review. */
+const stillPaid = (result, error) => {
+	const metadata = {
+		...result.metadata,
+		error,
+		needs_review: true
+	};
+	return {
+		...result,
+		status: "PAID",
+		metadata,
+		error
+	};
+};
+const voidError = (outcome, attempt) => {
+	const p1 = {
+		provider_message: outcome.message,
+		attempt
+	};
+	const code = outcome.code == null ? null : String(outcome.code);
+	const extra = {
+		...p1,
+		provider_code: code
+	};
+	if (isDefinitive(outcome)) {
+		const message = "CliSiTef refused the void";
+		return createPaymentError("REVERSAL_NOT_ALLOWED", {
+			...extra,
+			message,
+			retryable: false
+		});
+	}
+	if (outcome.aborted || code === null) return createPaymentError("PROVIDER_UNAVAILABLE", {
+		...extra,
+		retryable: true
+	});
+	return {
+		...toPaymentError(clisitefPinPadErrors, {
+			code: outcome.code,
+			message: outcome.message,
+			attempt,
+			fallback: "PROVIDER_UNAVAILABLE"
+		}),
+		retryable: true
+	};
+};
+/**
+* Voids a confirmed charge with its cancellation function (credit 210,
+* debit and voucher 211, PIX 123). `REFUNDED` only after `stage 2` = 0;
+* any other end keeps the charge `PAID` with `needs_review`, and a
+* retryable one goes to the pending queue.
+*/
+const runClisitefVoid = async (deps, ctx, result) => {
+	if (result.status === "REFUNDED") return result;
+	const reference = result.metadata.attempt_reference;
+	const done = await readRefund(ctx.storage, reference);
+	if (done) return done;
+	const target = targetOf(result);
+	if (!target) {
+		const error = createPaymentError("MANUAL_REVERSAL_REQUIRED", {
+			message: "Missing CliSiTef void context (host NSU, date, modality)",
+			retryable: false,
+			attempt: ctx.attempt
+		});
+		return stillPaid(result, error);
+	}
+	const { settings } = ctx;
+	const date = deps.now();
+	const queue = async (error, paid) => {
+		const r1 = {
+			attemptReference: reference,
+			amount: result.amount
+		};
+		const r2 = { transactionDate: target.transactionDate };
+		const r3 = {
+			hostNsu: target.hostNsu,
+			modality: target.modality
+		};
+		const entry = {
+			...r1,
+			...r2,
+			...r3,
+			reason: error.message,
+			result
+		};
+		await queueReversal(ctx.storage, entry, date.getTime());
+		return paid;
+	};
+	if (ctx.unavailable) {
+		const error = {
+			...ctx.unavailable,
+			retryable: true
+		};
+		return queue(error, stillPaid(result, error));
+	}
+	const fiscal = clisitefFiscalDateTime(date, deps.timeZone);
+	const fiscalCoupon = String(date.getTime());
+	const finish = {
+		fiscalCoupon,
+		...fiscal
+	};
+	const fn = CLISITEF_VOID_FUNCTION[target.modality];
+	const value = formatClisitefAmount(result.amount);
+	const s1 = {
+		modality: fn,
+		value,
+		...finish,
+		operator: settings.operator
+	};
+	const answers = {
+		[CLISITEF_VOID_FIELD.AMOUNT]: value,
+		[CLISITEF_VOID_FIELD.ORIGINAL_DATE]: toDdMmYyyy(target.transactionDate),
+		[CLISITEF_VOID_FIELD.ORIGINAL_HOST_NSU]: target.hostNsu
+	};
+	if (settings.supervisorPassword) answers[CLISITEF_VOID_FIELD.SUPERVISOR_PASSWORD] = settings.supervisorPassword;
+	const outcome = await runClisitefTransaction({
+		client: deps.client,
+		ui: ctx.ui,
+		signal: ctx.signal,
+		start: {
+			...s1,
+			restrictions: ""
+		},
+		finish,
+		confirmationTimeoutMs: deps.confirmationTimeoutMs,
+		modality: target.modality,
+		purpose: "void",
+		onApproved: async () => void 0,
+		answerField: (fieldId) => answers[fieldId] ?? null
+	});
+	if (outcome.code === -1) deps.client.invalidate();
+	const voided = clisitefVoidMetadata({
+		fields: outcome.fields,
+		function: fn,
+		fiscalCoupon,
+		fiscalDate: fiscal.fiscalDate
+	});
+	const provider = {
+		...result.metadata.provider,
+		void: voided
+	};
+	if (outcome.status === "confirmed") {
+		const metadata = {
+			...result.metadata,
+			provider
+		};
+		delete metadata.error;
+		delete metadata.needs_review;
+		const refunded = {
+			...result,
+			status: "REFUNDED",
+			metadata,
+			error: void 0
+		};
+		await writeRefund(ctx.storage, reference, refunded);
+		await dropReversal(ctx.storage, reference);
+		return refunded;
+	}
+	const error = voidError(outcome, ctx.attempt);
+	const withVoid = {
+		...result,
+		metadata: {
+			...result.metadata,
+			provider
+		}
+	};
+	const paid = stillPaid(withVoid, error);
+	if (!error.retryable) {
+		await dropReversal(ctx.storage, reference);
+		return paid;
+	}
+	return queue(error, paid);
+};
+//#endregion
+//#region src/settings.ts
+const CLISITEF_PINPAD_TYPES = [
+	"ANDROID_USB",
+	"ANDROID_BT",
+	"ANDROID_AUTO"
+];
+/**
+* Ficha §6: filled per kiosk in the device settings. SiTef IP, store code
+* and store CNPJ come from the payment's store settings (`config.stores`);
+* the device values only override them.
+*/
+const clisitefPinPadDeviceFields = [
+	{
+		key: "terminal_number",
+		label: "SiTef terminal number",
+		type: "text",
+		required: true
+	},
+	{
+		key: "pinpad_type",
+		label: "Pinpad connection",
+		type: "select",
+		options: [...CLISITEF_PINPAD_TYPES]
+	},
+	{
+		key: "secret_supervisor_password",
+		label: "SiTef supervisor password (voids)",
+		type: "password",
+		secret: true
+	}
+];
+const redactSecrets = (values = {}) => {
+	const entries = Object.entries(values).map(([key, value]) => {
+		return [key, (key.startsWith("secret_") || key === "supervisorPassword") && value ? "********" : value];
+	});
+	return Object.fromEntries(entries);
+};
+const redactStores = (stores) => {
+	if (!stores || typeof stores !== "object") return stores;
+	const redacted = Object.entries(stores).map(([id, store]) => {
+		return [id, redactSecrets(store && typeof store === "object" ? store : {})];
+	});
+	return Object.fromEntries(redacted);
+};
+/** The API only sends the entry of the kiosk's store. */
+const storeSettingsOf = (config) => {
+	const stores = config.stores;
+	if (!stores || typeof stores !== "object") return {};
+	const [first] = Object.values(stores);
+	return first && typeof first === "object" ? first : {};
+};
+const CLISITEF_MODALITIES = [
+	"DEBIT",
+	"CREDIT",
+	"VOUCHER",
+	"PIX"
+];
+const text = (value) => {
+	return typeof value === "string" ? value.trim() : "";
+};
+const notConfigured = (missing) => {
+	return new PaymentError(createPaymentError("TERMINAL_NOT_CONFIGURED", { message: `CliSiTef is missing ${missing.join(", ")}` }));
+};
+const isClisitefModality = (value) => {
+	return CLISITEF_MODALITIES.includes(value);
+};
+/** `modalities`, or the legacy single `modality` of older configs. */
+const listModalities = (config) => {
+	const listed = Array.isArray(config.modalities) ? config.modalities : [];
+	return (listed.length ? listed : [config.modality]).map(text).filter(Boolean);
+};
+/**
+* Per modality. The legacy single `restrictions` only applies to configs
+* without `restrictions_by_modality`: one modality never borrows another's
+* list (the credit one makes SiTef reject vouchers with `-3`).
+*/
+const readRestrictions = (config, modalities) => {
+	const raw = config.restrictions_by_modality;
+	const hasByModality = !!raw && typeof raw === "object";
+	const byModality = hasByModality ? raw : {};
+	const legacy = hasByModality ? "" : text(config.restrictions);
+	const entries = modalities.map((modality) => {
+		return [modality, text(byModality[modality]) || legacy];
+	});
+	return Object.fromEntries(entries.filter(([, value]) => value));
+};
+/** `payments.config` (merchant) + device settings; throws when incomplete. */
+const readClisitefPinPadSettings = (config, device) => {
+	const listed = listModalities(config);
+	const cnpjEnterprise = text(config.cnpj_enterprise);
+	const store = storeSettingsOf(config);
+	const serverIp = text(device.sitef_ip) || text(store.sitef_ip);
+	const storeCode = text(device.store_code) || text(store.store_code);
+	const terminalNumber = text(device.terminal_number);
+	const cnpjStore = (text(device.cnpj_store) || text(store.cnpj_store)).replace(/\D/g, "");
+	const pinpadType = text(device.pinpad_type) || void 0;
+	const required = {
+		modalities: listed.join(","),
+		cnpj_enterprise: cnpjEnterprise
+	};
+	const fromDevice = {
+		sitef_ip: serverIp,
+		store_code: storeCode
+	};
+	const more = {
+		terminal_number: terminalNumber,
+		cnpj_store: cnpjStore
+	};
+	const values = {
+		...required,
+		...fromDevice
+	};
+	Object.assign(values, more);
+	const missing = Object.keys(values).filter((key) => !values[key]);
+	const shown = redactSecrets(device);
+	clisitefDebug("pinpad.settings", "read", {
+		config: {
+			...config,
+			stores: redactStores(config.stores)
+		},
+		device: shown,
+		missing
+	});
+	if (missing.length) throw notConfigured(missing);
+	if (!listed.every(isClisitefModality)) throw notConfigured(["a valid modality"]);
+	const configure = {
+		serverIp,
+		storeCode,
+		terminalNumber,
+		additionalParams: clisitefAdditionalParams({
+			cnpjStore,
+			cnpjEnterprise,
+			pinpadType
+		})
+	};
+	const operator = text(config.operator) || "KIOSKO_BR";
+	const unique = [...new Set(listed)];
+	const restrictions = readRestrictions(config, unique);
+	const devicePassword = text(device.secret_supervisor_password);
+	const storePassword = text(store.secret_supervisor_password);
+	return {
+		configure,
+		modalities: unique,
+		operator,
+		restrictions,
+		terminalNumber,
+		supervisorPassword: devicePassword || storePassword || ""
+	};
+};
+//#endregion
+//#region src/store.ts
+const isRecord = (value) => {
+	if (!value || typeof value !== "object") return false;
+	const record = value;
+	return typeof record.fiscalCoupon === "string" && typeof record.attemptReference === "string";
+};
+const readTransaction = async (storage, key = CLISITEF_STORAGE_KEY) => {
+	const raw = await storage.get(key);
+	clisitefDebug("pinpad.store", "read", { raw });
+	if (!raw) return null;
+	try {
+		const parsed = JSON.parse(raw);
+		return isRecord(parsed) ? parsed : null;
+	} catch {
+		return null;
+	}
+};
+const writeTransaction = async (storage, record, key = CLISITEF_STORAGE_KEY) => {
+	clisitefDebug("pinpad.store", `write ${record.state}`, record);
+	await storage.set(key, JSON.stringify(record));
+};
+const isOpen = (record) => {
+	return record.state === "started" || record.state === "approved";
+};
+//#endregion
 //#region src/adapter.ts
 /** Confirmed in the act (`finishTransaction(1)`), never captured later. */
 const clisitefPinPadCapabilities = {
@@ -713,6 +1204,17 @@ const paid = (record) => {
 		details
 	};
 };
+/**
+* Silence, a deadline or an inconclusive code after the card was read, a
+* receipt arrived or the PIX QR was shown: the customer may have paid.
+*/
+const isAmbiguous = (outcome) => {
+	if (outcome.status === "unresolved") return true;
+	if (!outcome.evidence || outcome.status !== "undone") return false;
+	const { code } = outcome;
+	const inconclusive = typeof code === "number" && CLISITEF_INCONCLUSIVE_CODES.has(code);
+	return outcome.aborted || inconclusive || code === CLISITEF_TIMEOUT_CODE;
+};
 const outcomeError = (outcome, attempt) => {
 	const provider = {
 		provider_message: outcome.message,
@@ -723,8 +1225,8 @@ const outcomeError = (outcome, attempt) => {
 		...provider,
 		provider_code: code
 	};
+	if (isAmbiguous(outcome)) return createPaymentError("AMBIGUOUS", extra);
 	if (outcome.aborted) return createPaymentError("TIMEOUT", extra);
-	if (outcome.status === "unresolved") return createPaymentError("AMBIGUOUS", extra);
 	if (outcome.code === null) {
 		const message = outcome.message ?? void 0;
 		return createPaymentError("PROVIDER_UNAVAILABLE", {
@@ -744,7 +1246,8 @@ const outcomeError = (outcome, attempt) => {
 const MODALITY_LABELS = {
 	DEBIT: "Débito",
 	CREDIT: "Crédito",
-	VOUCHER: "Voucher"
+	VOUCHER: "Voucher",
+	PIX: "Pix"
 };
 /** The only modality, or the one the customer picks. */
 const chooseModality = async (ui, modalities) => {
@@ -762,15 +1265,20 @@ const chooseModality = async (ui, modalities) => {
 	});
 };
 const debugContext = (ctx) => {
-	const { attemptReference, attempt, amount, config, deviceSettings } = ctx;
+	const { attemptReference, attempt, amount, config } = ctx;
 	return {
 		attemptReference,
 		attempt,
 		amount,
 		config,
-		deviceSettings
+		deviceSettings: redactSecrets(ctx.deviceSettings)
 	};
 };
+/** `review` when the customer may have paid; `approved` when the undo failed. */
+const closingState = (outcome) => {
+	if (outcome.status === "unresolved") return "approved";
+	return isAmbiguous(outcome) ? "review" : "undone";
+};
 const terminalError = (error) => {
 	const message = error instanceof Error ? error.message : String(error);
 	return {
@@ -799,7 +1307,7 @@ const clisitefPinPadPayments = (options = {}) => {
 		const code = await client.configure(settings.configure);
 		clisitefDebug("pinpad.adapter.configure", "result", {
 			code,
-			settings
+			settings: redactSecrets(settings)
 		});
 		if (code === 0) return null;
 		client.invalidate();
@@ -809,7 +1317,7 @@ const clisitefPinPadPayments = (options = {}) => {
 		});
 	};
 	/** Undoes a transaction a crash or a lost result left open. */
-	const recover = async (storage, record) => {
+	const recover = async (storage, record, key = CLISITEF_STORAGE_KEY) => {
 		const { fiscalCoupon, fiscalDate, time } = record;
 		const count = client.getQttPendingTransactions;
 		const pending = await count(fiscalDate, fiscalCoupon).catch(() => null);
@@ -857,27 +1365,37 @@ const clisitefPinPadPayments = (options = {}) => {
 			};
 		}
 		clisitefDebug("pinpad.adapter.recover", `→ ${next.state}`, next);
-		await writeTransaction(storage, next);
+		await writeTransaction(storage, next, key);
 		return next;
 	};
-	/** Configures and resolves the open record of the device, if any. */
+	/** Configures and resolves the open records of the device, if any. */
 	const prepare = async (ctx) => {
 		const settings = readClisitefPinPadSettings(ctx.config, ctx.deviceSettings);
 		const error = await configure(settings);
 		const storage = storageOf(ctx);
-		let record = await readTransaction(storage);
-		if (!error && record && isOpen(record)) record = await recover(storage, record);
+		const resolve = async (key) => {
+			const found = await readTransaction(storage, key);
+			if (error || !found || !isOpen(found)) return found;
+			return recover(storage, found, key);
+		};
+		const record = await resolve(CLISITEF_STORAGE_KEY);
+		const refund = await resolve(CLISITEF_REFUND_STORAGE_KEY);
 		clisitefDebug("pinpad.adapter.prepare", "done", {
 			error,
-			record
+			record,
+			refund
 		});
 		return {
 			settings,
 			error,
 			storage,
-			record
+			record,
+			refund
 		};
 	};
+	const busy = (records) => {
+		return records.some((record) => record !== null && isOpen(record));
+	};
 	const fromRecord = (record, ctx) => {
 		const reference = ctx.attemptReference;
 		if (record.state === "confirmed") return paid(record);
@@ -904,7 +1422,7 @@ const clisitefPinPadPayments = (options = {}) => {
 		const { settings, storage, record: previous } = prepared;
 		if (prepared.error) return failed(empty, reference, prepared.error);
 		if (previous?.attemptReference === reference && previous?.state === "confirmed") return paid(previous);
-		if (previous && isOpen(previous)) {
+		if (busy([previous, prepared.refund])) {
 			const error = createPaymentError("TERMINAL_BUSY", { attempt: ctx.attempt });
 			return failed(empty, reference, error);
 		}
@@ -973,9 +1491,14 @@ const clisitefPinPadPayments = (options = {}) => {
 			confirmationTimeoutMs: confirmationMs,
 			onApproved
 		};
+		const t3 = {
+			modality: chosen,
+			purpose: "charge"
+		};
 		const outcome = await runClisitefTransaction({
 			...t1,
-			...t2
+			...t2,
+			...t3
 		});
 		const fields = Object.fromEntries(outcome.fields);
 		clisitefDebug("pinpad.adapter.charge", "outcome", {
@@ -996,17 +1519,68 @@ const clisitefPinPadPayments = (options = {}) => {
 		}
 		if (outcome.code === -1) client.invalidate();
 		const error = outcomeError(outcome, ctx.attempt);
-		const unresolved = outcome.status === "unresolved";
-		const state = unresolved ? "approved" : "undone";
+		const ambiguous = error.code === "AMBIGUOUS";
 		const closed = {
 			...record,
-			state,
+			state: closingState(outcome),
 			metadata,
 			error
 		};
 		await writeTransaction(storage, closed);
 		if (outcome.error) throw outcome.error;
-		return failed(closed, reference, error, unresolved);
+		return failed(closed, reference, error, ambiguous);
+	};
+	const voidDeps = {
+		client,
+		now,
+		timeZone: options.timeZone,
+		confirmationTimeoutMs: confirmationMs
+	};
+	/** Prepares the pinpad (recovering an open charge) and voids `result`. */
+	const refund = async (ctx, result) => {
+		const prepared = await prepare(ctx);
+		const { settings, storage, record } = prepared;
+		const busy = record && isOpen(record);
+		const busyError = createPaymentError("TERMINAL_BUSY");
+		const unavailable = prepared.error ?? (busy ? busyError : null);
+		const v1 = {
+			ui: ctx.ui,
+			signal: ctx.signal,
+			storage,
+			settings
+		};
+		const v2 = {
+			attempt: ctx.attempt,
+			unavailable
+		};
+		return runClisitefVoid(voidDeps, {
+			...v1,
+			...v2
+		}, result);
+	};
+	const retryReversals = async (ctx) => {
+		const settings = readClisitefPinPadSettings(ctx.config, ctx.deviceSettings);
+		const error = await configure(settings);
+		if (error) throw new Error(error.message);
+		const storage = storageOf(ctx);
+		const pending = await readPendingReversals(storage);
+		let refunded = 0;
+		for (const entry of pending) {
+			const v1 = {
+				ui: ctx.ui,
+				signal: ctx.signal,
+				storage,
+				settings
+			};
+			const v2 = { attempt: entry.attempts + 1 };
+			const ctx1 = {
+				...v1,
+				...v2
+			};
+			if ((await runClisitefVoid(voidDeps, ctx1, entry.result)).status === "REFUNDED") refunded += 1;
+		}
+		const left = (await readPendingReversals(storage)).length;
+		return `Voids completed: ${refunded}, pending: ${left}`;
 	};
 	const query = async (ctx, result) => {
 		const reference = result.metadata.attempt_reference;
@@ -1046,9 +1620,10 @@ const clisitefPinPadPayments = (options = {}) => {
 	const operation = (run, name = "terminal") => {
 		return (ctx) => {
 			const scope = `pinpad.terminal.${name}`;
+			const deviceSettings = redactSecrets(ctx.deviceSettings);
 			const input = {
 				config: ctx.config,
-				deviceSettings: ctx.deviceSettings
+				deviceSettings
 			};
 			const traced = () => clisitefDebugCall(scope, input, task);
 			const task = async () => {
@@ -1078,22 +1653,30 @@ const clisitefPinPadPayments = (options = {}) => {
 			return `CliSiTef ${await client.getVersion()}`;
 		}, "test"),
 		status: operation(async () => client.getHealth() ?? {}, "status"),
-		extra: [{
-			key: "submit_pending_messages",
-			label: "Send pending messages",
-			run: operation(async () => {
-				return `Pending messages sent (${await client.submitPendingMessages()})`;
-			}, "submit_pending_messages")
-		}, {
-			key: "release_pinpad",
-			label: "Release pinpad",
-			run: operation(async () => {
-				await client.closePinPad();
-				await client.disconnectSitef();
-				client.invalidate();
-				return "Pinpad released";
-			}, "release_pinpad")
-		}]
+		extra: [
+			{
+				key: "submit_pending_messages",
+				label: "Send pending messages",
+				run: operation(async () => {
+					return `Pending messages sent (${await client.submitPendingMessages()})`;
+				}, "submit_pending_messages")
+			},
+			{
+				key: "retry_pending_reversals",
+				label: "Retry pending voids",
+				run: operation(retryReversals, "retry_pending_reversals")
+			},
+			{
+				key: "release_pinpad",
+				label: "Release pinpad",
+				run: operation(async () => {
+					await client.closePinPad();
+					await client.disconnectSitef();
+					client.invalidate();
+					return "Pinpad released";
+				}, "release_pinpad")
+			}
+		]
 	};
 	return {
 		provider: "clisitef",
@@ -1123,9 +1706,17 @@ const clisitefPinPadPayments = (options = {}) => {
 			const run = () => cancel(ctx, result);
 			return lock(() => clisitefDebugCall("pinpad.cancel", input, run));
 		},
-		reversalFor: (result) => result.status === "PAID" ? "manual" : "cancel",
+		refund: (ctx, result) => {
+			const input = {
+				ctx: debugContext(ctx),
+				result
+			};
+			const run = () => refund(ctx, result);
+			return lock(() => clisitefDebugCall("pinpad.refund", input, run));
+		},
+		reversalFor: (result) => result.status === "PAID" ? "refund" : "cancel",
 		terminal
 	};
 };
 //#endregion
-export { CLISITEF_CANCEL_CODES, CLISITEF_CAPTURE_FIELDS, CLISITEF_COMMAND, CLISITEF_CONFIRMATION_TIMEOUT_MS, CLISITEF_DEFAULT_OPERATOR, CLISITEF_FIELD, CLISITEF_INCONCLUSIVE_CODES, CLISITEF_NO, CLISITEF_PAYMENT_TIMEOUT_MS, CLISITEF_PINPAD_TYPES, CLISITEF_STORAGE_KEY, CLISITEF_YES, clisitefDetails, clisitefLast4, clisitefMetadata, clisitefPinPadCapabilities, clisitefPinPadDeviceFields, clisitefPinPadErrors, clisitefPinPadPayments, isOpen, readClisitefPinPadSettings, readTransaction, runClisitefTransaction, writeTransaction };
+export { CLISITEF_CANCEL_CODES, CLISITEF_CAPTURE_FIELDS, CLISITEF_COMMAND, CLISITEF_CONFIRMATION_TIMEOUT_MS, CLISITEF_DEFAULT_OPERATOR, CLISITEF_FIELD, CLISITEF_INCONCLUSIVE_CODES, CLISITEF_MODALITIES, CLISITEF_NO, CLISITEF_PAYMENT_TIMEOUT_MS, CLISITEF_PINPAD_TYPES, CLISITEF_REFUNDS_KEY, CLISITEF_REFUND_STORAGE_KEY, CLISITEF_REVERSALS_KEY, CLISITEF_STORAGE_KEY, CLISITEF_VOID_FIELD, CLISITEF_YES, clisitefDetails, clisitefLast4, clisitefMetadata, clisitefModalityOf, clisitefPinPadCapabilities, clisitefPinPadDeviceFields, clisitefPinPadErrors, clisitefPinPadPayments, clisitefVoidMetadata, dropReversal, isClisitefModality, isOpen, queueReversal, readClisitefPinPadSettings, readPendingReversals, readRefund, readTransaction, redactSecrets, resolveClisitefMenu, runClisitefTransaction, runClisitefVoid, writeRefund, writeTransaction };