@networksolution/sia-vpos-node 1.0.0

package/dist/types.js

@@ -0,0 +1,46 @@
+"use strict";
+// ─── Configuration ────────────────────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LINK_STATUS = exports.RESULT_CODES = void 0;
+// ─── Result codes ────────────────────────────────────────────────────────────
+exports.RESULT_CODES = {
+    '00': 'Success',
+    '01': 'Order or ReqRefNum not found',
+    '02': 'ReqRefNum duplicated or not valid',
+    '03': 'Incorrect message format, missing or incorrect field',
+    '04': 'Incorrect API authentication, incorrect MAC',
+    '05': 'Incorrect date, or period indicated is empty',
+    '06': 'Unforeseen error in the circuit during processing of request',
+    '07': 'TransactionID not found',
+    '08': 'Operator indicated not found',
+    '09': 'TRANSACTIONID does not reference the entered ORDERID',
+    '10': 'Amount exceeds maximum amount permitted',
+    '11': 'Incorrect status. Transaction not possible in the current status',
+    '12': 'Circuit disabled',
+    '13': 'Duplicated order',
+    '16': 'Currency not supported or not available for the merchant',
+    '17': 'Exponent not supported for the chosen currency',
+    '20': 'VBV/SecureCode/SafeKey-enabled card, redirection needed',
+    '21': 'Maximum time-limit for VBV request step 2 expired',
+    '25': 'A call to 3DS method must be performed by the Requestor',
+    '26': 'A challenge flow must be initiated by the Requestor',
+    '35': 'No payment instrument is acceptable',
+    '37': 'Missing CVV2',
+    '38': 'Pan alias not found or revoked',
+    '40': 'Empty XML or missing data parameter',
+    '41': 'XML not parsable',
+    '50': 'Installments not available',
+    '51': 'Installment number out of bounds',
+    '52': 'No link found with the preset search criteria',
+    '98': 'Application error',
+    '99': 'Transaction failed, see specific outcome in Data element',
+};
+exports.LINK_STATUS = {
+    '00': 'Created',
+    '01': 'Returned',
+    '02': 'Sent',
+    '03': 'Used',
+    '04': 'Paid',
+    '05': 'Revoked',
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA,iFAAiF;;;AAkTjF,gFAAgF;AAEnE,QAAA,YAAY,GAA2B;IAClD,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,8BAA8B;IACpC,IAAI,EAAE,mCAAmC;IACzC,IAAI,EAAE,sDAAsD;IAC5D,IAAI,EAAE,6CAA6C;IACnD,IAAI,EAAE,8CAA8C;IACpD,IAAI,EAAE,8DAA8D;IACpE,IAAI,EAAE,yBAAyB;IAC/B,IAAI,EAAE,8BAA8B;IACpC,IAAI,EAAE,sDAAsD;IAC5D,IAAI,EAAE,yCAAyC;IAC/C,IAAI,EAAE,kEAAkE;IACxE,IAAI,EAAE,kBAAkB;IACxB,IAAI,EAAE,kBAAkB;IACxB,IAAI,EAAE,0DAA0D;IAChE,IAAI,EAAE,gDAAgD;IACtD,IAAI,EAAE,yDAAyD;IAC/D,IAAI,EAAE,mDAAmD;IACzD,IAAI,EAAE,yDAAyD;IAC/D,IAAI,EAAE,qDAAqD;IAC3D,IAAI,EAAE,qCAAqC;IAC3C,IAAI,EAAE,cAAc;IACpB,IAAI,EAAE,gCAAgC;IACtC,IAAI,EAAE,qCAAqC;IAC3C,IAAI,EAAE,kBAAkB;IACxB,IAAI,EAAE,4BAA4B;IAClC,IAAI,EAAE,kCAAkC;IACxC,IAAI,EAAE,+CAA+C;IACrD,IAAI,EAAE,mBAAmB;IACzB,IAAI,EAAE,0DAA0D;CACjE,CAAC;AAEW,QAAA,WAAW,GAA2B;IACjD,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,SAAS;CAChB,CAAC"}

package/dist/vpos-client.d.ts

@@ -0,0 +1,425 @@
+import type { VposConfig, AuthorizationRequest, CreateLinkRequest, ListLinkRequest, RevokeLinkRequest, AccountingRequest, ReverseAccountingRequest, RefundRequest, OrderStatusRequest } from './types';
+/**
+ * Generate timestamp in yyyy-MM-ddTHH:mm:ss.SSS format
+ */
+export declare function generateTimestamp(date?: Date): string;
+/**
+ * Generate ReqRefNum: first 8 digits = yyyyMMdd, remaining 24 = random numeric
+ * Total: 32 chars numeric
+ */
+export declare function generateReqRefNum(date?: Date): string;
+export declare class VposClient {
+    private config;
+    constructor(config: VposConfig);
+    /** Returns true if using the test environment */
+    get isTest(): boolean;
+    /** Returns true if using the production environment */
+    get isProduction(): boolean;
+    /** Returns the current API URL */
+    get apiUrl(): string;
+    private sendRequest;
+    authorize(data: AuthorizationRequest): Promise<{
+        authorization: {
+            paymentType: string;
+            authorizationType: string;
+            transactionId: string;
+            network: string;
+            orderId: string;
+            transactionAmount: string;
+            authorizedAmount: string;
+            currency: string;
+            exponent: string;
+            accountedAmount: string;
+            refundedAmount: string;
+            transactionResult: string;
+            timestamp: string;
+            authorizationNumber: string;
+            acquirerBIN: string;
+            merchantId: string;
+            transactionStatus: string;
+            responseCodeISO: string | undefined;
+            panTail: string | undefined;
+            panExpiryDate: string | undefined;
+            paymentTypePP: string | undefined;
+            rrn: string | undefined;
+            cardType: string | undefined;
+            cardholderInfo: string | undefined;
+            ibanCode: string | undefined;
+            mac: string;
+        } | undefined;
+        panAliasData: {
+            panAlias: string;
+            panAliasRev: string;
+            panAliasExpDate: string;
+            panAliasTail: string;
+            cRecurr: string | undefined;
+            mac: string;
+        } | undefined;
+        timestamp: string;
+        result: string;
+        mac: string;
+        data?: string;
+        rawXml: string;
+    }>;
+    createLink(data: CreateLinkRequest): Promise<{
+        linkCreated: {
+            completeLink: string;
+            token: string;
+            creationDate: string;
+            status: string;
+            lastUseDate: string;
+            expirationDate: string;
+            revokeDate: string;
+            orderId: string;
+            mac: string;
+        } | undefined;
+        timestamp: string;
+        result: string;
+        mac: string;
+        data?: string;
+        rawXml: string;
+    }>;
+    listLinks(data: ListLinkRequest): Promise<{
+        links: {
+            completeLink: string;
+            token: string;
+            creationDate: string;
+            status: string;
+            lastUseDate: string;
+            expirationDate: string;
+            revokeDate: string;
+            orderId: string;
+            mac: string;
+        }[];
+        timestamp: string;
+        result: string;
+        mac: string;
+        data?: string;
+        rawXml: string;
+    }>;
+    revokeLink(data: RevokeLinkRequest): Promise<{
+        timestamp: string;
+        result: string;
+        mac: string;
+        data?: string;
+        rawXml: string;
+    }>;
+    accounting(data: AccountingRequest): Promise<{
+        operation: {
+            transactionId: string;
+            timestampReq: string;
+            timestampElab: string;
+            srcType: string;
+            amount: string;
+            result: string;
+            status: string;
+            opDescr: string | undefined;
+            mac: string;
+            authorization: {
+                paymentType: string;
+                authorizationType: string;
+                transactionId: string;
+                network: string;
+                orderId: string;
+                transactionAmount: string;
+                authorizedAmount: string;
+                currency: string;
+                exponent: string;
+                accountedAmount: string;
+                refundedAmount: string;
+                transactionResult: string;
+                timestamp: string;
+                authorizationNumber: string;
+                acquirerBIN: string;
+                merchantId: string;
+                transactionStatus: string;
+                responseCodeISO: string | undefined;
+                panTail: string | undefined;
+                panExpiryDate: string | undefined;
+                paymentTypePP: string | undefined;
+                rrn: string | undefined;
+                cardType: string | undefined;
+                cardholderInfo: string | undefined;
+                ibanCode: string | undefined;
+                mac: string;
+            } | undefined;
+        } | undefined;
+        timestamp: string;
+        result: string;
+        mac: string;
+        data?: string;
+        rawXml: string;
+    }>;
+    reverseAccounting(data: ReverseAccountingRequest): Promise<{
+        operation: {
+            transactionId: string;
+            timestampReq: string;
+            timestampElab: string;
+            srcType: string;
+            amount: string;
+            result: string;
+            status: string;
+            opDescr: string | undefined;
+            mac: string;
+            authorization: {
+                paymentType: string;
+                authorizationType: string;
+                transactionId: string;
+                network: string;
+                orderId: string;
+                transactionAmount: string;
+                authorizedAmount: string;
+                currency: string;
+                exponent: string;
+                accountedAmount: string;
+                refundedAmount: string;
+                transactionResult: string;
+                timestamp: string;
+                authorizationNumber: string;
+                acquirerBIN: string;
+                merchantId: string;
+                transactionStatus: string;
+                responseCodeISO: string | undefined;
+                panTail: string | undefined;
+                panExpiryDate: string | undefined;
+                paymentTypePP: string | undefined;
+                rrn: string | undefined;
+                cardType: string | undefined;
+                cardholderInfo: string | undefined;
+                ibanCode: string | undefined;
+                mac: string;
+            } | undefined;
+        } | undefined;
+        timestamp: string;
+        result: string;
+        mac: string;
+        data?: string;
+        rawXml: string;
+    }>;
+    refund(data: RefundRequest): Promise<{
+        operation: {
+            transactionId: string;
+            timestampReq: string;
+            timestampElab: string;
+            srcType: string;
+            amount: string;
+            result: string;
+            status: string;
+            opDescr: string | undefined;
+            mac: string;
+            authorization: {
+                paymentType: string;
+                authorizationType: string;
+                transactionId: string;
+                network: string;
+                orderId: string;
+                transactionAmount: string;
+                authorizedAmount: string;
+                currency: string;
+                exponent: string;
+                accountedAmount: string;
+                refundedAmount: string;
+                transactionResult: string;
+                timestamp: string;
+                authorizationNumber: string;
+                acquirerBIN: string;
+                merchantId: string;
+                transactionStatus: string;
+                responseCodeISO: string | undefined;
+                panTail: string | undefined;
+                panExpiryDate: string | undefined;
+                paymentTypePP: string | undefined;
+                rrn: string | undefined;
+                cardType: string | undefined;
+                cardholderInfo: string | undefined;
+                ibanCode: string | undefined;
+                mac: string;
+            } | undefined;
+        } | undefined;
+        timestamp: string;
+        result: string;
+        mac: string;
+        data?: string;
+        rawXml: string;
+    }>;
+    orderStatus(data: OrderStatusRequest): Promise<{
+        authorization: {
+            paymentType: string;
+            authorizationType: string;
+            transactionId: string;
+            network: string;
+            orderId: string;
+            transactionAmount: string;
+            authorizedAmount: string;
+            currency: string;
+            exponent: string;
+            accountedAmount: string;
+            refundedAmount: string;
+            transactionResult: string;
+            timestamp: string;
+            authorizationNumber: string;
+            acquirerBIN: string;
+            merchantId: string;
+            transactionStatus: string;
+            responseCodeISO: string | undefined;
+            panTail: string | undefined;
+            panExpiryDate: string | undefined;
+            paymentTypePP: string | undefined;
+            rrn: string | undefined;
+            cardType: string | undefined;
+            cardholderInfo: string | undefined;
+            ibanCode: string | undefined;
+            mac: string;
+        } | undefined;
+        panAliasData: {
+            panAlias: string;
+            panAliasRev: string;
+            panAliasExpDate: string;
+            panAliasTail: string;
+            cRecurr: string | undefined;
+            mac: string;
+        } | undefined;
+        timestamp: string;
+        result: string;
+        mac: string;
+        data?: string;
+        rawXml: string;
+    }>;
+    /**
+     * Verify the MAC of a BPWXmlResponse received from SIA (webhook/URLMS notification).
+     * Verifies the root-level MAC (Timestamp + Result) per spec 4.2.7.
+     */
+    verifyResponseMAC(responseXml: string): boolean;
+    /**
+     * Verify the root-level response MAC (spec 4.2.7).
+     * MAC = Hash(timestamp&result&secretstring) for SHA-1/MD5
+     * MAC = HMAC(timestamp&result, secretkey) for HMAC-256
+     */
+    verifyBPWResponseMAC(timestamp: string, result: string, receivedMac: string): boolean;
+    /**
+     * Verify the Authorization element MAC (spec 4.2.9).
+     * Use this for verifying authorization data in webhook responses.
+     */
+    verifyAuthorizationMAC(auth: {
+        authorizationType: string;
+        transactionId: string;
+        network: string;
+        orderId: string;
+        transactionAmount: string;
+        authorizedAmount: string;
+        currency: string;
+        accountedAmount: string;
+        refundedAmount?: string;
+        transactionResult: string;
+        timestamp: string;
+        authorizationNumber: string;
+        acquirerBIN: string;
+        merchantId: string;
+        transactionStatus: string;
+        responseCodeISO?: string;
+        panTail?: string;
+        panExpiryDate?: string;
+        paymentTypePP?: string;
+        rrn?: string;
+        cardType?: string;
+        cardholderInfo?: string;
+        mac: string;
+    }): boolean;
+    /**
+     * Parse a webhook/notification XML response and return structured data.
+     */
+    parseWebhook(responseXml: string): {
+        authorization: {
+            paymentType: string;
+            authorizationType: string;
+            transactionId: string;
+            network: string;
+            orderId: string;
+            transactionAmount: string;
+            authorizedAmount: string;
+            currency: string;
+            exponent: string;
+            accountedAmount: string;
+            refundedAmount: string;
+            transactionResult: string;
+            timestamp: string;
+            authorizationNumber: string;
+            acquirerBIN: string;
+            merchantId: string;
+            transactionStatus: string;
+            responseCodeISO: string | undefined;
+            panTail: string | undefined;
+            panExpiryDate: string | undefined;
+            paymentTypePP: string | undefined;
+            rrn: string | undefined;
+            cardType: string | undefined;
+            cardholderInfo: string | undefined;
+            ibanCode: string | undefined;
+            mac: string;
+        } | undefined;
+        panAliasData: {
+            panAlias: string;
+            panAliasRev: string;
+            panAliasExpDate: string;
+            panAliasTail: string;
+            cRecurr: string | undefined;
+            mac: string;
+        } | undefined;
+        operation: {
+            transactionId: string;
+            timestampReq: string;
+            timestampElab: string;
+            srcType: string;
+            amount: string;
+            result: string;
+            status: string;
+            opDescr: string | undefined;
+            mac: string;
+            authorization: {
+                paymentType: string;
+                authorizationType: string;
+                transactionId: string;
+                network: string;
+                orderId: string;
+                transactionAmount: string;
+                authorizedAmount: string;
+                currency: string;
+                exponent: string;
+                accountedAmount: string;
+                refundedAmount: string;
+                transactionResult: string;
+                timestamp: string;
+                authorizationNumber: string;
+                acquirerBIN: string;
+                merchantId: string;
+                transactionStatus: string;
+                responseCodeISO: string | undefined;
+                panTail: string | undefined;
+                panExpiryDate: string | undefined;
+                paymentTypePP: string | undefined;
+                rrn: string | undefined;
+                cardType: string | undefined;
+                cardholderInfo: string | undefined;
+                ibanCode: string | undefined;
+                mac: string;
+            } | undefined;
+        } | undefined;
+        linkCreated: {
+            completeLink: string;
+            token: string;
+            creationDate: string;
+            status: string;
+            lastUseDate: string;
+            expirationDate: string;
+            revokeDate: string;
+            orderId: string;
+            mac: string;
+        } | undefined;
+        timestamp: string;
+        result: string;
+        mac: string;
+        data?: string;
+        rawXml: string;
+    };
+}
+//# sourceMappingURL=vpos-client.d.ts.map

package/dist/vpos-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vpos-client.d.ts","sourceRoot":"","sources":["../src/vpos-client.ts"],"names":[],"mappings":"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"}