globalpayments-api 3.10.13 → 3.10.15

package/lib/src/Terminals/UPA/Reponses/UpaEODResponse.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpaEODResponse = void 0;
+const src_1 = require("../../../../src");
+class UpaEODResponse {
+    status;
+    command;
+    version = "";
+    deviceResponseCode;
+    deviceResponseText;
+    deviceResponseMessage;
+    referenceNumber = "";
+    batchId;
+    gatewayResponseCode;
+    gatewayResponseMessage;
+    respDateTime;
+    multipleMessage;
+    constructor(jsonResponse) {
+        if (typeof jsonResponse === "string") {
+            try {
+                jsonResponse = JSON.parse(jsonResponse);
+            }
+            catch {
+                throw new src_1.NotImplementedError("Invalid JSON string");
+            }
+        }
+        this.version = this.extractVersion(jsonResponse);
+        this.referenceNumber = this.extractReferenceNumber(jsonResponse);
+        if (this.isGpApiResponse(jsonResponse)) {
+            const response = jsonResponse.response;
+            const cmdResult = response?.cmdResult;
+            this.status = cmdResult?.result ?? jsonResponse.status ?? "";
+            this.command = response?.response ?? "";
+            this.deviceResponseCode = this.normalizeDeviceResponseCode(cmdResult?.errorCode, jsonResponse.action?.result_code);
+            this.deviceResponseText = this.status;
+            this.deviceResponseMessage = cmdResult?.errorMessage ?? "";
+            const responseData = response?.data;
+            if (responseData) {
+                this.multipleMessage = responseData.multipleMessage;
+                const host = responseData.host;
+                if (host) {
+                    this.referenceNumber = host.referenceNumber ?? this.referenceNumber;
+                    this.respDateTime = host.respDateTime;
+                    this.batchId = host.batchId;
+                    this.gatewayResponseCode = host.gatewayResponseCode;
+                    this.gatewayResponseMessage = host.gatewayResponseMessage;
+                }
+            }
+        }
+        else {
+            // Native UPA device response
+            const data = jsonResponse?.data;
+            const cmdResult = data?.cmdResult;
+            this.deviceResponseText = cmdResult?.result ?? "";
+            this.deviceResponseCode = cmdResult?.errorCode ?? "00";
+            this.status = this.deviceResponseText;
+            this.deviceResponseMessage = cmdResult?.errorMessage ?? "";
+            this.command = data?.response ?? "";
+            const innerData = data?.data;
+            if (innerData) {
+                this.referenceNumber =
+                    innerData.referenceNumber ?? this.referenceNumber;
+                this.multipleMessage = innerData.multipleMessage;
+                const host = innerData.host;
+                if (host) {
+                    this.referenceNumber = host.referenceNumber ?? this.referenceNumber;
+                    this.respDateTime = host.respDateTime;
+                    this.batchId = host.batchId;
+                    this.gatewayResponseCode = host.gatewayResponseCode;
+                    this.gatewayResponseMessage = host.gatewayResponseMessage;
+                }
+            }
+        }
+    }
+    isGpApiResponse(jsonResponse) {
+        return !!(jsonResponse.provider && jsonResponse.provider === src_1.GatewayProvider.GpApi);
+    }
+    normalizeDeviceResponseCode(cmdErrorCode, actionResultCode) {
+        if (cmdErrorCode) {
+            return cmdErrorCode;
+        }
+        return actionResultCode === "SUCCESS" ? "00" : actionResultCode ?? "";
+    }
+    extractVersion(jsonResponse) {
+        return (jsonResponse?.version ??
+            jsonResponse?.response?.version ??
+            jsonResponse?.data?.version ??
+            jsonResponse?.data?.data?.version ??
+            "");
+    }
+    extractReferenceNumber(jsonResponse) {
+        return (jsonResponse?.referenceNumber ??
+            jsonResponse?.response?.referenceNumber ??
+            jsonResponse?.response?.data?.referenceNumber ??
+            jsonResponse?.response?.data?.host?.referenceNumber ??
+            jsonResponse?.data?.referenceNumber ??
+            jsonResponse?.data?.data?.referenceNumber ??
+            jsonResponse?.data?.data?.host?.referenceNumber ??
+            "");
+    }
+    toString() {
+        return JSON.stringify(this);
+    }
+}
+exports.UpaEODResponse = UpaEODResponse;
+//# sourceMappingURL=UpaEODResponse.js.map

package/lib/src/Terminals/UPA/Reponses/UpaEODResponse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UpaEODResponse.js","sourceRoot":"","sources":["../../../../../src/Terminals/UPA/Reponses/UpaEODResponse.ts"],"names":[],"mappings":"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"}

package/lib/src/Terminals/UPA/Reponses/UpaGiftCardResponse.d.ts

@@ -0,0 +1,41 @@
+import { TransactionResponse } from "./TransactionResponse";
+/**
+ * Response from StartCardTransaction.
+ */
+export declare class UpaGiftCardResponse extends TransactionResponse {
+    acquisitionType: string;
+    luhnCheckPassed: string;
+    dataEncryptionType: string;
+    serviceCode: string;
+    fallback: string;
+    clearPan: string;
+    maskedPan: string;
+    encryptedPan: string;
+    clearTrack1: string;
+    maskedTrack1: string;
+    clearTrack2: string;
+    maskedTrack2: string;
+    clearTrack3: string;
+    maskedTrack3: string;
+    emvTags: string;
+    expiryDate: string;
+    cvv: string;
+    address: string;
+    zipCode: string;
+    scannedData: string;
+    pinBlock: string;
+    pinKsn: string;
+    encryptedBlob: string;
+    encryptedBlobKsn: string;
+    cardType: string;
+    cardBrand: string;
+    cardBrandShortName: string;
+    cardSecurityPromptFlag: string;
+    avsFlag: string;
+    cashBackFlag: string;
+    surchargeFlag: string;
+    ebtCardType: string;
+    dccEligible: string;
+    constructor(jsonResponse: any);
+    private extractResponseData;
+}

package/lib/src/Terminals/UPA/Reponses/UpaGiftCardResponse.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpaGiftCardResponse = void 0;
+const TransactionResponse_1 = require("./TransactionResponse");
+/**
+ * Response from StartCardTransaction.
+ */
+class UpaGiftCardResponse extends TransactionResponse_1.TransactionResponse {
+    acquisitionType = "";
+    luhnCheckPassed = "";
+    dataEncryptionType = "";
+    serviceCode = "";
+    fallback = "";
+    clearPan = "";
+    maskedPan = "";
+    encryptedPan = "";
+    clearTrack1 = "";
+    maskedTrack1 = "";
+    clearTrack2 = "";
+    maskedTrack2 = "";
+    clearTrack3 = "";
+    maskedTrack3 = "";
+    emvTags = "";
+    expiryDate = "";
+    cvv = "";
+    address = "";
+    zipCode = "";
+    scannedData = "";
+    pinBlock = "";
+    pinKsn = "";
+    encryptedBlob = "";
+    encryptedBlobKsn = "";
+    cardType = "";
+    cardBrand = "";
+    cardBrandShortName = "";
+    cardSecurityPromptFlag = "";
+    avsFlag = "";
+    cashBackFlag = "";
+    surchargeFlag = "";
+    ebtCardType = "";
+    dccEligible = "";
+    constructor(jsonResponse) {
+        super(jsonResponse);
+        const responseData = this.extractResponseData(jsonResponse);
+        const pan = responseData?.PAN ?? responseData?.Pan;
+        const trackData = responseData?.trackData;
+        const pinDukpt = responseData?.PinDUKPT;
+        const tripleDesDukpt = responseData?.["3DesDukpt"];
+        const cardBinDetails = responseData?.CardBinDetails;
+        this.acquisitionType = responseData?.acquisitionType ?? "";
+        this.luhnCheckPassed = responseData?.LuhnCheckPassed ?? "";
+        this.dataEncryptionType = responseData?.dataEncryptionType ?? "";
+        this.serviceCode = responseData?.serviceCode ?? "";
+        this.fallback = responseData?.fallback ?? "";
+        this.clearPan = pan?.clearPAN ?? "";
+        this.maskedPan = pan?.maskedPAN ?? "";
+        this.encryptedPan = pan?.encryptedPAN ?? "";
+        this.clearTrack1 = trackData?.clearTrack1 ?? "";
+        this.maskedTrack1 = trackData?.maskedTrack1 ?? "";
+        this.clearTrack2 = trackData?.clearTrack2 ?? "";
+        this.maskedTrack2 = trackData?.maskedTrack2 ?? "";
+        this.clearTrack3 = trackData?.clearTrack3 ?? "";
+        this.maskedTrack3 = trackData?.maskedTrack3 ?? "";
+        this.emvTags = responseData?.EmvTags ?? "";
+        this.expiryDate = responseData?.expiryDate ?? "";
+        this.expirationDate = this.expiryDate || this.expirationDate;
+        this.cvv = responseData?.Cvv ?? "";
+        this.address = responseData?.address ?? "";
+        this.zipCode = responseData?.zipCode ?? "";
+        this.scannedData = responseData?.ScannedData ?? "";
+        this.pinBlock = pinDukpt?.PinBlock ?? "";
+        this.pinKsn = pinDukpt?.Ksn ?? "";
+        this.encryptedBlob = tripleDesDukpt?.encryptedBlob ?? "";
+        this.encryptedBlobKsn = tripleDesDukpt?.Ksn ?? "";
+        this.cardType = cardBinDetails?.cardType ?? "";
+        this.cardBrand = cardBinDetails?.cardBrand ?? "";
+        this.cardBrandShortName = cardBinDetails?.cardBrandShortName ?? "";
+        this.cardSecurityPromptFlag = cardBinDetails?.cardSecurityPromptFlag ?? "";
+        this.avsFlag = cardBinDetails?.AVSFlag ?? "";
+        this.cashBackFlag = cardBinDetails?.cashBackFlag ?? "";
+        this.surchargeFlag = cardBinDetails?.surchargeFlag ?? "";
+        this.ebtCardType = cardBinDetails?.EBTCardType ?? "";
+        this.dccEligible = cardBinDetails?.DCCEligible ?? "";
+    }
+    extractResponseData(jsonResponse) {
+        if (jsonResponse?.provider && jsonResponse?.response?.data) {
+            return jsonResponse.response.data;
+        }
+        return jsonResponse?.data?.data ?? {};
+    }
+}
+exports.UpaGiftCardResponse = UpaGiftCardResponse;
+//# sourceMappingURL=UpaGiftCardResponse.js.map

package/lib/src/Terminals/UPA/Reponses/UpaGiftCardResponse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UpaGiftCardResponse.js","sourceRoot":"","sources":["../../../../../src/Terminals/UPA/Reponses/UpaGiftCardResponse.ts"],"names":[],"mappings":"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"}

package/lib/src/Terminals/UPA/Reponses/UpaSAFResponse.d.ts

@@ -0,0 +1,35 @@
+import { ISAFResponse, SummaryType, TransactionSummary } from "../../../../src";
+export declare class UpaSafSummaryResponse {
+    totalAmount?: number;
+    count?: number;
+    summaryType: SummaryType;
+    transactions: TransactionSummary[];
+}
+export declare class UpaSAFResponse implements ISAFResponse {
+    status: string;
+    command: string;
+    version: string;
+    deviceResponseCode: string;
+    deviceResponseText: string;
+    deviceResponseMessage?: string;
+    referenceNumber: string;
+    totalCount?: number;
+    totalAmount?: number;
+    multipleMessage?: string;
+    approved?: Record<number, UpaSafSummaryResponse>;
+    pending?: Record<number, UpaSafSummaryResponse>;
+    declined?: Record<number, UpaSafSummaryResponse>;
+    constructor(jsonResponse: any);
+    private parseSafDetails;
+    private assignSummary;
+    private mapTransactionSummary;
+    private mapSummaryType;
+    private toDate;
+    private toNumber;
+    private isGpApiResponse;
+    private normalizeDeviceResponseCode;
+    private extractVersion;
+    private extractReferenceNumber;
+    private extractCommand;
+    toString(): string;
+}

package/lib/src/Terminals/UPA/Reponses/UpaSAFResponse.js

@@ -0,0 +1,194 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpaSAFResponse = exports.UpaSafSummaryResponse = void 0;
+const src_1 = require("../../../../src");
+class UpaSafSummaryResponse {
+    totalAmount;
+    count;
+    summaryType;
+    transactions = [];
+}
+exports.UpaSafSummaryResponse = UpaSafSummaryResponse;
+class UpaSAFResponse {
+    status;
+    command;
+    version = "";
+    deviceResponseCode;
+    deviceResponseText;
+    deviceResponseMessage;
+    referenceNumber = "";
+    totalCount;
+    totalAmount;
+    multipleMessage;
+    approved;
+    pending;
+    declined;
+    constructor(jsonResponse) {
+        if (typeof jsonResponse === "string") {
+            try {
+                jsonResponse = JSON.parse(jsonResponse);
+            }
+            catch {
+                throw new src_1.NotImplementedError("Invalid JSON string");
+            }
+        }
+        this.version = this.extractVersion(jsonResponse);
+        this.referenceNumber = this.extractReferenceNumber(jsonResponse);
+        if (this.isGpApiResponse(jsonResponse)) {
+            const response = jsonResponse.response;
+            const cmdResult = response?.cmdResult;
+            this.status = cmdResult?.result ?? jsonResponse.status ?? "";
+            this.command = this.extractCommand(jsonResponse, response?.response);
+            this.deviceResponseCode = this.normalizeDeviceResponseCode(cmdResult?.errorCode, jsonResponse.action?.result_code);
+            this.deviceResponseText = this.status;
+            this.deviceResponseMessage = cmdResult?.errorMessage ?? "";
+            const responseData = response?.data;
+            if (responseData) {
+                this.referenceNumber =
+                    responseData.referenceNumber ?? this.referenceNumber;
+                this.multipleMessage = responseData.multipleMessage;
+                const safDetails = responseData.SafDetails || [];
+                safDetails.forEach((detail) => {
+                    this.totalAmount =
+                        (this.totalAmount || 0) + Number(detail.SafTotal || 0);
+                    this.totalCount =
+                        (this.totalCount || 0) + Number(detail.SafCount || 0);
+                });
+            }
+        }
+        else {
+            // Native UPA device response
+            const data = jsonResponse?.data;
+            const cmdResult = data?.cmdResult;
+            this.deviceResponseText = cmdResult?.result ?? "";
+            this.deviceResponseCode = cmdResult?.errorCode ?? "00";
+            this.status = this.deviceResponseText;
+            this.deviceResponseMessage = cmdResult?.errorMessage ?? "";
+            this.command = this.extractCommand(jsonResponse, data?.response);
+            const innerData = data?.data;
+            if (innerData) {
+                this.referenceNumber =
+                    innerData.referenceNumber ?? this.referenceNumber;
+                this.multipleMessage = innerData.multipleMessage;
+                this.parseSafDetails(innerData.SafDetails);
+            }
+        }
+    }
+    parseSafDetails(safDetails) {
+        const details = Array.isArray(safDetails) ? safDetails : [];
+        details.forEach((detail) => {
+            const summary = new UpaSafSummaryResponse();
+            summary.totalAmount = this.toNumber(detail?.SafTotal) ?? 0;
+            summary.count = this.toNumber(detail?.SafCount) ?? 0;
+            summary.summaryType = this.mapSummaryType(detail?.SafType);
+            summary.transactions = Array.isArray(detail?.SafRecords)
+                ? detail.SafRecords.map((record) => this.mapTransactionSummary(record))
+                : [];
+            this.totalAmount = (this.totalAmount || 0) + (summary.totalAmount || 0);
+            this.totalCount = (this.totalCount || 0) + (summary.count || 0);
+            this.assignSummary(summary);
+        });
+    }
+    assignSummary(summary) {
+        if (summary.summaryType === src_1.SummaryType.Approved) {
+            this.approved = this.approved ?? {};
+            this.approved[summary.summaryType] = summary;
+            return;
+        }
+        if (summary.summaryType === src_1.SummaryType.Pending) {
+            this.pending = this.pending ?? {};
+            this.pending[summary.summaryType] = summary;
+            return;
+        }
+        this.declined = this.declined ?? {};
+        this.declined[summary.summaryType] = summary;
+    }
+    mapTransactionSummary(record) {
+        const summary = new src_1.TransactionSummary();
+        summary.transactionType = record?.transactionType;
+        summary.transactionId = record?.transId;
+        summary.referenceNumber = record?.referenceNumber;
+        summary.gratuityAmount = record?.tipAmount;
+        summary.taxAmount = record?.taxAmount;
+        summary.amount = record?.baseAmount;
+        summary.authorizedAmount = record?.authorizedAmount;
+        summary.cardType = record?.cardType;
+        summary.maskedCardNumber = record?.maskedPan;
+        summary.authCode = record?.approvalCode;
+        summary.entryMode = record?.cardAcquisition;
+        summary.status = record?.responseCode;
+        const transactionDate = this.toDate(record?.transactionTime);
+        if (transactionDate) {
+            summary.transactionDate = transactionDate;
+        }
+        return summary;
+    }
+    mapSummaryType(safType) {
+        switch (safType) {
+            case "AUTHORIZED TRANSACTIONS":
+                return src_1.SummaryType.Approved;
+            case "PENDING TRANSACTIONS":
+                return src_1.SummaryType.Pending;
+            case "FAILED TRANSACTIONS":
+            default:
+                return src_1.SummaryType.Declined;
+        }
+    }
+    toDate(value) {
+        if (!value) {
+            return undefined;
+        }
+        const date = new Date(value);
+        return Number.isNaN(date.getTime()) ? undefined : date;
+    }
+    toNumber(value) {
+        if (value === undefined || value === null || value === "") {
+            return undefined;
+        }
+        const parsed = Number(value);
+        return Number.isNaN(parsed) ? undefined : parsed;
+    }
+    isGpApiResponse(jsonResponse) {
+        return !!(jsonResponse.provider && jsonResponse.provider === src_1.GatewayProvider.GpApi);
+    }
+    normalizeDeviceResponseCode(cmdErrorCode, actionResultCode) {
+        if (cmdErrorCode) {
+            return cmdErrorCode;
+        }
+        return actionResultCode === "SUCCESS" ? "00" : actionResultCode ?? "";
+    }
+    extractVersion(jsonResponse) {
+        return (jsonResponse?.version ??
+            jsonResponse?.response?.version ??
+            jsonResponse?.data?.version ??
+            jsonResponse?.data?.data?.version ??
+            "");
+    }
+    extractReferenceNumber(jsonResponse) {
+        return (jsonResponse?.referenceNumber ??
+            jsonResponse?.response?.referenceNumber ??
+            jsonResponse?.response?.data?.referenceNumber ??
+            jsonResponse?.response?.data?.host?.referenceNumber ??
+            jsonResponse?.data?.referenceNumber ??
+            jsonResponse?.data?.data?.referenceNumber ??
+            jsonResponse?.data?.data?.host?.referenceNumber ??
+            "");
+    }
+    extractCommand(jsonResponse, fallback) {
+        if (fallback && fallback !== "SendCommand") {
+            return fallback;
+        }
+        return (jsonResponse?.requestType ??
+            jsonResponse?.command ??
+            jsonResponse?.response?.command ??
+            jsonResponse?.data?.command ??
+            jsonResponse?.data?.data?.command ??
+            fallback ??
+            "");
+    }
+    toString() {
+        return JSON.stringify(this);
+    }
+}
+exports.UpaSAFResponse = UpaSAFResponse;
+//# sourceMappingURL=UpaSAFResponse.js.map

package/lib/src/Terminals/UPA/Reponses/UpaSAFResponse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UpaSAFResponse.js","sourceRoot":"","sources":["../../../../../src/Terminals/UPA/Reponses/UpaSAFResponse.ts"],"names":[],"mappings":"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"}

package/lib/src/Terminals/UPA/Reponses/UpaSignatureResponse.d.ts

@@ -0,0 +1,18 @@
+/// <reference types="node" />
+import { ISignatureResponse } from "../../../../src";
+export declare class UpaSignatureResponse implements ISignatureResponse {
+    status: string;
+    command: string;
+    version: string;
+    deviceResponseCode: string;
+    deviceResponseText: string;
+    referenceNumber: string;
+    signatureData?: Buffer;
+    sigData?: string;
+    constructor(jsonResponse: any);
+    private isGpApiResponse;
+    private normalizeDeviceResponseCode;
+    private extractVersion;
+    private extractReferenceNumber;
+    toString(): string;
+}

package/lib/src/Terminals/UPA/Reponses/UpaSignatureResponse.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpaSignatureResponse = void 0;
+const src_1 = require("../../../../src");
+class UpaSignatureResponse {
+    status;
+    command;
+    version = "";
+    deviceResponseCode;
+    deviceResponseText;
+    referenceNumber = "";
+    signatureData;
+    sigData;
+    constructor(jsonResponse) {
+        if (typeof jsonResponse === "string") {
+            try {
+                jsonResponse = JSON.parse(jsonResponse);
+            }
+            catch {
+                throw new src_1.NotImplementedError("Invalid JSON string");
+            }
+        }
+        this.version = this.extractVersion(jsonResponse);
+        this.referenceNumber = this.extractReferenceNumber(jsonResponse);
+        if (this.isGpApiResponse(jsonResponse)) {
+            const response = jsonResponse.response;
+            const cmdResult = response?.cmdResult;
+            this.status = cmdResult?.result ?? jsonResponse.status ?? "";
+            this.command = response?.response ?? "";
+            this.deviceResponseText = this.status;
+            this.deviceResponseCode = this.normalizeDeviceResponseCode(cmdResult?.errorCode, jsonResponse.action?.result_code);
+            const responseData = response?.data;
+            if (responseData) {
+                this.referenceNumber =
+                    responseData.referenceNumber ?? this.referenceNumber;
+                const rawSigData = responseData.signatureData;
+                if (rawSigData) {
+                    this.sigData = rawSigData;
+                    this.signatureData = Buffer.from(rawSigData, "base64");
+                }
+            }
+        }
+        else {
+            // Native UPA device response
+            const data = jsonResponse?.data;
+            const cmdResult = data?.cmdResult;
+            this.deviceResponseText = cmdResult?.result ?? "";
+            this.deviceResponseCode = cmdResult?.errorCode ?? "00";
+            this.status = this.deviceResponseText;
+            this.command = data?.response ?? "";
+            const innerData = data?.data;
+            if (innerData) {
+                this.referenceNumber =
+                    innerData.referenceNumber ?? this.referenceNumber;
+                const rawSigData = innerData.signatureData;
+                if (rawSigData) {
+                    this.sigData = rawSigData;
+                    this.signatureData = Buffer.from(rawSigData, "base64");
+                }
+            }
+        }
+    }
+    isGpApiResponse(jsonResponse) {
+        return !!(jsonResponse.provider && jsonResponse.provider === src_1.GatewayProvider.GpApi);
+    }
+    normalizeDeviceResponseCode(cmdErrorCode, actionResultCode) {
+        if (cmdErrorCode) {
+            return cmdErrorCode;
+        }
+        return actionResultCode === "SUCCESS" ? "00" : actionResultCode ?? "";
+    }
+    extractVersion(jsonResponse) {
+        return (jsonResponse?.version ??
+            jsonResponse?.response?.version ??
+            jsonResponse?.data?.version ??
+            jsonResponse?.data?.data?.version ??
+            "");
+    }
+    extractReferenceNumber(jsonResponse) {
+        return (jsonResponse?.referenceNumber ??
+            jsonResponse?.response?.referenceNumber ??
+            jsonResponse?.response?.data?.referenceNumber ??
+            jsonResponse?.response?.data?.host?.referenceNumber ??
+            jsonResponse?.data?.referenceNumber ??
+            jsonResponse?.data?.data?.referenceNumber ??
+            jsonResponse?.data?.data?.host?.referenceNumber ??
+            "");
+    }
+    toString() {
+        return JSON.stringify(this);
+    }
+}
+exports.UpaSignatureResponse = UpaSignatureResponse;
+//# sourceMappingURL=UpaSignatureResponse.js.map

package/lib/src/Terminals/UPA/Reponses/UpaSignatureResponse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UpaSignatureResponse.js","sourceRoot":"","sources":["../../../../../src/Terminals/UPA/Reponses/UpaSignatureResponse.ts"],"names":[],"mappings":"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"}

package/lib/src/Terminals/UPA/UpaController.js

@@ -57,7 +57,7 @@ class UpaController extends DeviceController_1.DeviceController {
         };
         const requestData = {
             command: this.mapTransactionType(transactionType),
-            EcrId: builder.ecrId,
+            EcrId: builder.ecrId?.toString(),
             requestId: requestId.toString(),
         };
         const transactionData = {
@@ -73,6 +73,9 @@ class UpaController extends DeviceController_1.DeviceController {
         transactionData.transaction.taxIndicator = builder.taxIndicator;
         transactionData.transaction.invoiceNbr = builder.invoiceNumber;
         transactionData.transaction.processCPC = builder.processCPC;
+        if (transactionType === src_1.TransactionType.Refund) {
+            transactionData.transaction.totalAmount = builder.amount?.toFixed(2);
+        }
         requestData.data = transactionData;
         request.data = requestData;
         return TerminalUtils_1.TerminalUtils.buildUpaRequest(request);