@unchainedshop/plugins 4.0.0-rc.4 → 4.0.0-rc.6

package/lib/payment/postfinance-checkout/utils.d.ts

@@ -1,5 +1,5 @@
 import { Order } from '@unchainedshop/core-orders';
-import * as pf from 'postfinancecheckout';
-export declare const transactionIsPaid: (transaction: pf.PostFinanceCheckout.model.Transaction, expectedCurrency: string, expectedAmount: number) => Promise<boolean>;
-export declare const orderIsPaid: (order: Order, transaction: pf.PostFinanceCheckout.model.Transaction) => Promise<boolean>;
+import { Transaction } from './api-types.js';
+export declare const transactionIsPaid: (transaction: Transaction, expectedCurrency: string, expectedAmount: number) => Promise<boolean>;
+export declare const orderIsPaid: (order: Order, transaction: Transaction) => Promise<boolean>;
 //# sourceMappingURL=utils.d.ts.map

package/lib/payment/postfinance-checkout/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/payment/postfinance-checkout/utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AACnD,OAAO,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAI1C,eAAO,MAAM,iBAAiB,GAC5B,aAAa,EAAE,CAAC,mBAAmB,CAAC,KAAK,CAAC,WAAW,EACrD,kBAAkB,MAAM,EACxB,gBAAgB,MAAM,KACrB,OAAO,CAAC,OAAO,CAgBjB,CAAC;AAEF,eAAO,MAAM,WAAW,GACtB,OAAO,KAAK,EACZ,aAAa,EAAE,CAAC,mBAAmB,CAAC,KAAK,CAAC,WAAW,KACpD,OAAO,CAAC,OAAO,CAOjB,CAAC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/payment/postfinance-checkout/utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AACnD,OAAO,EAAE,WAAW,EAAoB,MAAM,gBAAgB,CAAC;AAE/D,eAAO,MAAM,iBAAiB,GAC5B,aAAa,WAAW,EACxB,kBAAkB,MAAM,EACxB,gBAAgB,MAAM,KACrB,OAAO,CAAC,OAAO,CAgBjB,CAAC;AAEF,eAAO,MAAM,WAAW,GAAU,OAAO,KAAK,EAAE,aAAa,WAAW,KAAG,OAAO,CAAC,OAAO,CAOzF,CAAC"}

package/lib/payment/postfinance-checkout/utils.js

@@ -1,13 +1,12 @@
 import { OrderPricingSheet } from '@unchainedshop/core';
-import * as pf from 'postfinancecheckout';
-const { PostFinanceCheckout } = pf;
+import { TransactionState } from './api-types.js';
 export const transactionIsPaid = async (transaction, expectedCurrency, expectedAmount) => {
-    if (transaction.state === PostFinanceCheckout.model.TransactionState.FULFILL) {
+    if (transaction.state === TransactionState.FULFILL) {
         return (transaction.completedAmount !== undefined &&
             transaction.completedAmount.toFixed(2) === expectedAmount.toFixed(2) &&
             transaction.currency === expectedCurrency);
     }
-    if (transaction.state === PostFinanceCheckout.model.TransactionState.AUTHORIZED) {
+    if (transaction.state === TransactionState.AUTHORIZED) {
         return (transaction.authorizationAmount !== undefined &&
             transaction.authorizationAmount.toFixed(2) === expectedAmount.toFixed(2) &&
             transaction.currency === expectedCurrency);

package/lib/payment/postfinance-checkout/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/payment/postfinance-checkout/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAE1C,MAAM,EAAE,mBAAmB,EAAE,GAAG,EAAE,CAAC;AAEnC,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,EACpC,WAAqD,EACrD,gBAAwB,EACxB,cAAsB,EACJ,EAAE;IACpB,IAAI,WAAW,CAAC,KAAK,KAAK,mBAAmB,CAAC,KAAK,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC;QAC7E,OAAO,CACL,WAAW,CAAC,eAAe,KAAK,SAAS;YACzC,WAAW,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;YACpE,WAAW,CAAC,QAAQ,KAAK,gBAAgB,CAC1C,CAAC;IACJ,CAAC;IACD,IAAI,WAAW,CAAC,KAAK,KAAK,mBAAmB,CAAC,KAAK,CAAC,gBAAgB,CAAC,UAAU,EAAE,CAAC;QAChF,OAAO,CACL,WAAW,CAAC,mBAAmB,KAAK,SAAS;YAC7C,WAAW,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;YACxE,WAAW,CAAC,QAAQ,KAAK,gBAAgB,CAC1C,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,EAC9B,KAAY,EACZ,WAAqD,EACnC,EAAE;IACpB,MAAM,OAAO,GAAG,iBAAiB,CAAC;QAChC,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,YAAY,EAAE,KAAK,CAAC,YAAY;KACjC,CAAC,CAAC;IACH,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC;IACvE,OAAO,iBAAiB,CAAC,WAAW,EAAE,KAAK,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;AACzE,CAAC,CAAC"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/payment/postfinance-checkout/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,EAAe,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAE/D,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,EACpC,WAAwB,EACxB,gBAAwB,EACxB,cAAsB,EACJ,EAAE;IACpB,IAAI,WAAW,CAAC,KAAK,KAAK,gBAAgB,CAAC,OAAO,EAAE,CAAC;QACnD,OAAO,CACL,WAAW,CAAC,eAAe,KAAK,SAAS;YACzC,WAAW,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;YACpE,WAAW,CAAC,QAAQ,KAAK,gBAAgB,CAC1C,CAAC;IACJ,CAAC;IACD,IAAI,WAAW,CAAC,KAAK,KAAK,gBAAgB,CAAC,UAAU,EAAE,CAAC;QACtD,OAAO,CACL,WAAW,CAAC,mBAAmB,KAAK,SAAS;YAC7C,WAAW,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;YACxE,WAAW,CAAC,QAAQ,KAAK,gBAAgB,CAC1C,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,EAAE,KAAY,EAAE,WAAwB,EAAoB,EAAE;IAC5F,MAAM,OAAO,GAAG,iBAAiB,CAAC;QAChC,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,YAAY,EAAE,KAAK,CAAC,YAAY;KACjC,CAAC,CAAC;IACH,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC;IACvE,OAAO,iBAAiB,CAAC,WAAW,EAAE,KAAK,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;AACzE,CAAC,CAAC"}

package/lib/presets/all.d.ts

@@ -58,7 +58,7 @@ declare const modules: {
         configure: ({ db }: {
             db: any;
         }) => {
-            createWriteStream: (directoryName: any, fileId: any, fileName: any, metadata: any) => Promise<import("mongodb").GridFSBucketWriteStream>;
+            createWriteStream: (directoryName: any, fileId: any, fileName: any, uploadOptions: import("mongodb").GridFSBucketWriteStream["options"]) => Promise<import("mongodb").GridFSBucketWriteStream>;
             getFileInfo: (directoryName: any, fileId: any) => Promise<import("mongodb").GridFSFile>;
             createReadStream: (directoryName: any, fileId: any) => Promise<import("mongodb").GridFSBucketReadStream>;
             removeFileFromBucket: (directoryName: any, fileId: any) => Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unchainedshop/plugins",
-  "version": "4.0.0-rc.4",
+  "version": "4.0.0-rc.6",
   "main": "lib/plugins-index.js",
   "types": "lib/plugins-index.d.ts",
   "exports": {
@@ -64,7 +64,6 @@
     "nodemailer": ">= 6.9 < 8",
     "open": "10.x",
     "p-memoize": "7.x",
-    "postfinancecheckout": ">= 4.5.0",
     "stripe": ">= 17 < 19",
     "web-push": ">= 3.6 <4",
     "xml-js": ">= 1.6 < 2"
@@ -112,9 +111,6 @@
     "p-memoize": {
       "optional": true
     },
-    "postfinancecheckout": {
-      "optional": true
-    },
     "stripe": {
       "optional": true
     },
@@ -128,22 +124,21 @@
   "devDependencies": {
     "@breejs/later": "^4.2.0",
     "@paypal/checkout-server-sdk": "^1.0.3",
-    "@redis/client": "^5.5.6",
+    "@redis/client": "^5.6.0",
     "@scure/bip32": "^1.7.0",
     "@scure/btc-signer": "^1.8.1",
     "@types/breejs__later": "^4.1.5",
     "@types/express": "^5.0.3",
-    "@types/node": "^24.0.4",
+    "@types/node": "^24.0.13",
     "expiry-map": "^2.0.0",
     "express": "^5.1.0",
     "fastify": "^5.4.0",
     "mime-types": "^3.0.1",
     "minio": "^8.0.5",
-    "nodemailer": "^7.0.3",
+    "nodemailer": "^7.0.5",
     "open": "^10.1.2",
     "p-memoize": "^7.1.1",
-    "postfinancecheckout": "^4.7.0",
-    "stripe": "^18.2.1",
+    "stripe": "^18.3.0",
     "tsx": "^4.20.3",
     "typescript": "^5.8.3",
     "web-push": "^3.6.7",

package/src/files/gridfs/adapter.ts

@@ -69,7 +69,7 @@ export const GridFSAdapter: IFileAdapter<
     } as UploadFileData & { putURL: string };
   },
 
-  async uploadFileFromStream(directoryName: string, rawFile: any, { modules }) {
+  async uploadFileFromStream(directoryName: string, rawFile: any, { modules }, options = {}) {
     let stream: Readable;
     let fileName;
     if (rawFile instanceof Promise) {
@@ -89,9 +89,16 @@ export const GridFSAdapter: IFileAdapter<
       directoryName,
       hashedFilename,
       fileName,
-      { 'content-type': type },
+      {
+        metadata: { 'content-type': type },
+        ...options,
+      },
+    );
+    await pipeline(
+      stream,
+      new PassThrough({ allowHalfOpen: true, highWaterMark: 1024 * 1024 }),
+      writeStream,
     );
-    await pipeline(stream, new PassThrough({ allowHalfOpen: true }), writeStream);
     const { length } = writeStream;
     const url = `/gridfs/${directoryName}/${encodeURIComponent(hashedFilename)}`;
 
@@ -125,7 +132,9 @@ export const GridFSAdapter: IFileAdapter<
       directoryName,
       hashedFilename,
       fileName,
-      { 'content-type': type },
+      {
+        metadata: { 'content-type': type },
+      },
     );
     await pipeline(response.body as unknown as Readable, new PassThrough(), writeStream);
     const { length } = writeStream;

package/src/files/gridfs/handler-express.ts

@@ -61,9 +61,15 @@ const gridfsHandler = async (
           directoryName,
           fileId,
           fileName,
-          { 'content-type': type },
+          {
+            metadata: { 'content-type': type },
+          },
+        );
+        await pipeline(
+          req,
+          new PassThrough({ allowHalfOpen: true, highWaterMark: 1024 * 1024 }),
+          writeStream,
         );
-        await pipeline(req, new PassThrough(), writeStream);
 
         const { length } = writeStream;
         await services.files.linkFile({ fileId, size: length, type });

package/src/files/gridfs/handler-fastify.ts

@@ -54,10 +54,16 @@ const gridfsHandler: RouteHandlerMethod = async (
           directoryName,
           fileId,
           fileName,
-          { 'content-type': type },
+          {
+            metadata: { 'content-type': type },
+          },
         );
 
-        await pipeline(req.raw, new PassThrough(), writeStream);
+        await pipeline(
+          req.raw,
+          new PassThrough({ allowHalfOpen: true, highWaterMark: 1024 * 1024 }),
+          writeStream,
+        );
 
         const { length } = writeStream;
         await services.files.linkFile({ fileId, size: length, type });

package/src/files/gridfs/module.ts

@@ -5,10 +5,15 @@ export const configureGridFSFileUploadModule = ({ db }) => {
   let { GridFSBucket } = mongodb;
 
   return {
-    createWriteStream: async (directoryName, fileId, fileName, metadata) => {
+    createWriteStream: async (
+      directoryName,
+      fileId,
+      fileName,
+      uploadOptions: mongodb.GridFSBucketWriteStream['options'],
+    ) => {
       const options = { bucketName: `file_uploads_${directoryName}` };
       const bucket = new GridFSBucket(db, options);
-      return bucket.openUploadStreamWithId(fileId, fileName, { metadata });
+      return bucket.openUploadStreamWithId(fileId, fileName, uploadOptions);
     },
     getFileInfo: async (directoryName, fileId) => {
       const options = { bucketName: `file_uploads_${directoryName}` };

package/src/payment/apple-iap/adapter.ts

@@ -3,7 +3,7 @@ import { createLogger } from '@unchainedshop/logger';
 import { AppleTransactionsModule } from './module.js';
 import { verifyReceipt } from './verify-receipt.js';
 
-const logger = createLogger('unchained:core-payment:iap');
+const logger = createLogger('unchained:core-payment:apple-iap');
 
 const { APPLE_IAP_SHARED_SECRET } = process.env;
 

package/src/payment/apple-iap/handler-express.ts

@@ -3,7 +3,7 @@ import { EnrollmentStatus } from '@unchainedshop/core-enrollments';
 import { createLogger } from '@unchainedshop/logger';
 import { fixPeriods } from './fix-periods.js';
 
-const logger = createLogger('unchained:core-payment:iap');
+const logger = createLogger('unchained:core-payment:apple-iap:handler');
 
 const { APPLE_IAP_SHARED_SECRET } = process.env;
 

package/src/payment/apple-iap/handler-fastify.ts

@@ -5,7 +5,7 @@ import { fixPeriods } from './fix-periods.js';
 import { FastifyRequest, RouteHandlerMethod } from 'fastify';
 import { AppleTransactionsModule } from './module.js';
 
-const logger = createLogger('unchained:core-payment:iap');
+const logger = createLogger('unchained:core-payment:apple-iap:handler');
 
 const { APPLE_IAP_SHARED_SECRET } = process.env;
 

package/src/payment/cryptopay/handle-webhook.ts

@@ -6,7 +6,7 @@ import { ProductPriceRate } from '@unchainedshop/core-products';
 
 const { CRYPTOPAY_SECRET, CRYPTOPAY_MAX_RATE_AGE = '360' } = process.env;
 
-const logger = createLogger('unchained:core-payment:cryptopay');
+const logger = createLogger('unchained:core-payment:cryptopay:handler');
 
 export default async function handleWebhook(
   {

package/src/payment/cryptopay/handler-express.ts

@@ -1,7 +1,7 @@
 import { createLogger } from '@unchainedshop/logger';
 import handleWebhook from './handle-webhook.js';
 
-const logger = createLogger('unchained:core-payment:cryptopay');
+const logger = createLogger('unchained:core-payment:cryptopay:handler');
 
 const cryptopayHandler = async (req, res) => {
   if (req.method === 'POST') {

package/src/payment/cryptopay/handler-fastify.ts

@@ -1,9 +1,9 @@
 import { createLogger } from '@unchainedshop/logger';
 import handleWebhook from './handle-webhook.js';
-
-const logger = createLogger('unchained:core-payment:cryptopay');
 import { FastifyRequest, RouteHandlerMethod } from 'fastify';
 
+const logger = createLogger('unchained:core-payment:cryptopay:handler');
+
 const cryptopayHandler: RouteHandlerMethod = async (
   req: FastifyRequest & {
     unchainedContext: any;

package/src/payment/paypal-checkout.ts

@@ -17,7 +17,7 @@ try {
   /* */
 }
 
-const logger = createLogger('unchained:core-payment');
+const logger = createLogger('unchained:core-payment:paypal-checkout');
 
 const { PAYPAL_CLIENT_ID, PAYPAL_SECRET, PAYPAL_ENVIRONMENT = 'sandbox' } = process.env;
 
@@ -79,7 +79,6 @@ const PaypalCheckout: IPaymentAdapter = {
         const { order } = context;
 
         if (!orderID) {
-          logger.warn('Paypal Native Plugin: PRICE MATCH');
           throw new Error('You have to provide orderID in paymentContext');
         }
 
@@ -96,21 +95,17 @@ const PaypalCheckout: IPaymentAdapter = {
           const paypalTotal = paypalOrder.result.purchase_units[0].amount.value;
 
           if (ourTotal === paypalTotal) {
-            logger.info('Paypal Native Plugin: PRICE MATCH');
             return order;
           }
 
-          logger.warn(
-            'Paypal Native Plugin: Missmatch PAYPAL ORDER',
-            JSON.stringify(paypalOrder.result, null, 2),
-          );
+          logger.warn('Missmatch PAYPAL ORDER', JSON.stringify(paypalOrder.result, null, 2));
 
-          logger.debug('Paypal Native Plugin: OUR ORDER', order);
-          logger.debug('Paypal Native Plugin: OUR PRICE', pricing);
+          logger.debug('OUR ORDER', order);
+          logger.debug('OUR PRICE', pricing);
 
           throw new Error(`Payment mismatch`);
         } catch (e) {
-          logger.warn('Paypal Native Plugin: Failed', e);
+          logger.warn(e);
           throw new Error(e);
         }
       },

package/src/payment/postfinance-checkout/api-client.ts

@@ -0,0 +1,106 @@
+import crypto from 'crypto';
+
+const API_BASE_URL = 'https://checkout.postfinance.ch/api';
+
+interface ApiConfig {
+  spaceId: number;
+  userId: number;
+  apiSecret: string;
+}
+
+interface MacHeaders {
+  'x-mac-version': string;
+  'x-mac-userid': string;
+  'x-mac-timestamp': string;
+  'x-mac-value': string;
+}
+
+export class PostFinanceApiClient {
+  private config: ApiConfig;
+
+  constructor(config: ApiConfig) {
+    this.config = config;
+  }
+
+  private generateMacHeaders(method: string, path: string): MacHeaders {
+    const version = '1';
+    const timestamp = Math.floor(Date.now() / 1000).toString();
+    const userId = this.config.userId.toString();
+
+    // Use path as-is since it already includes /api from the URL
+    const resourcePath = path;
+
+    const dataToSign = [version, userId, timestamp, method, resourcePath].join('|');
+
+    const macValue = crypto
+      .createHmac('sha512', Buffer.from(this.config.apiSecret, 'base64'))
+      .update(dataToSign, 'utf8')
+      .digest('base64');
+
+    return {
+      'x-mac-version': version,
+      'x-mac-userid': userId,
+      'x-mac-timestamp': timestamp,
+      'x-mac-value': macValue,
+    };
+  }
+
+  async request<T>(method: string, endpoint: string, body?: any): Promise<T> {
+    const url = `${API_BASE_URL}${endpoint}`;
+    const urlObj = new URL(url);
+    // Include both pathname and search (query parameters) for MAC signature
+    const pathWithQuery = urlObj.pathname + urlObj.search;
+    const macHeaders = this.generateMacHeaders(method, pathWithQuery);
+
+    const headers: Record<string, string> = {
+      ...macHeaders,
+      'Content-Type': 'application/json',
+      Accept: 'application/json',
+    };
+
+    const options: RequestInit = {
+      method,
+      headers,
+    };
+
+    if (body && method !== 'GET') {
+      options.body = JSON.stringify(body);
+    }
+
+    const response = await fetch(url, options);
+
+    if (!response.ok) {
+      const errorData = await response.json().catch(() => ({}));
+      throw new Error(
+        `PostFinance API error: ${response.status} ${response.statusText} ${JSON.stringify(errorData)}`,
+      );
+    }
+
+    const responseText = await response.text();
+    const contentType = response.headers.get('content-type');
+
+    if (contentType && contentType.includes('application/json')) {
+      try {
+        return JSON.parse(responseText);
+      } catch {
+        // If JSON parsing fails but content-type is json, return as text
+        // This handles PostFinance's payment-page-url endpoint that returns plain text with json content-type
+        return responseText as any;
+      }
+    } else {
+      return responseText as any;
+    }
+  }
+
+  get<T>(endpoint: string): Promise<T> {
+    return this.request<T>('GET', endpoint);
+  }
+
+  post<T>(endpoint: string, body: any): Promise<T> {
+    return this.request<T>('POST', endpoint, body);
+  }
+
+  patch<T>(endpoint: string, body: any): Promise<T> {
+    return this.request<T>('PATCH', endpoint, body);
+  }
+}

package/src/payment/postfinance-checkout/api-types.ts

@@ -0,0 +1,111 @@
+// PostFinance Checkout API Types
+
+export enum TransactionState {
+  CREATE = 'CREATE',
+  PENDING = 'PENDING',
+  CONFIRMED = 'CONFIRMED',
+  PROCESSING = 'PROCESSING',
+  FAILED = 'FAILED',
+  AUTHORIZED = 'AUTHORIZED',
+  VOIDED = 'VOIDED',
+  COMPLETED = 'COMPLETED',
+  FULFILL = 'FULFILL',
+  DECLINE = 'DECLINE',
+}
+
+export enum TokenizationMode {
+  FORCE_UPDATE = 'FORCE_UPDATE',
+  ALLOW = 'ALLOW',
+  ALLOW_ONE_CLICK_PAYMENT = 'ALLOW_ONE_CLICK_PAYMENT',
+  DENY = 'DENY',
+}
+
+export enum TransactionCompletionBehavior {
+  COMPLETE_IMMEDIATELY = 'COMPLETE_IMMEDIATELY',
+  COMPLETE_DEFERRED = 'COMPLETE_DEFERRED',
+  USE_CONFIGURATION = 'USE_CONFIGURATION',
+}
+
+export enum LineItemType {
+  SHIPPING = 'SHIPPING',
+  DISCOUNT = 'DISCOUNT',
+  FEE = 'FEE',
+  PRODUCT = 'PRODUCT',
+  TIP = 'TIP',
+}
+
+export enum RefundType {
+  MERCHANT_INITIATED_ONLINE = 'MERCHANT_INITIATED_ONLINE',
+  MERCHANT_INITIATED_OFFLINE = 'MERCHANT_INITIATED_OFFLINE',
+  CUSTOMER_INITIATED_AUTOMATIC = 'CUSTOMER_INITIATED_AUTOMATIC',
+  CUSTOMER_INITIATED_MANUAL = 'CUSTOMER_INITIATED_MANUAL',
+}
+
+export enum CreationEntityState {
+  CREATE = 'CREATE',
+  ACTIVE = 'ACTIVE',
+  INACTIVE = 'INACTIVE',
+  DELETING = 'DELETING',
+  DELETED = 'DELETED',
+}
+
+export interface LineItem {
+  name: string;
+  type: LineItemType;
+  quantity: number;
+  uniqueId: string;
+  amountIncludingTax: number;
+}
+
+export interface TransactionCreate {
+  currency: string;
+  customerId?: string;
+  tokenizationMode?: TokenizationMode;
+  completionBehavior?: TransactionCompletionBehavior;
+  lineItems?: LineItem[];
+  successUrl?: string;
+  failedUrl?: string;
+  metaData?: Record<string, any>;
+}
+
+export interface Transaction {
+  id: number;
+  state: TransactionState;
+  currency: string;
+  completedAmount?: number;
+  authorizationAmount?: number;
+  metaData?: Record<string, any>;
+  token?: {
+    id: number;
+    [key: string]: any;
+  };
+}
+
+export interface TransactionCompletion {
+  id: number;
+  state: string;
+  transaction: number;
+  linkedTransaction?: number;
+}
+
+export interface Token {
+  id: number;
+  state: CreationEntityState;
+  name?: string;
+  customerId?: string;
+  enabledForOneClickPayment?: boolean;
+}
+
+export interface RefundCreate {
+  transaction: number;
+  externalId: string;
+  amount: number;
+  type: RefundType;
+}
+
+export interface Refund {
+  id: number;
+  state: string;
+  amount: number;
+  transaction: number;
+}